版本控制与协作 / 系统课时

安装 Git 并验证版本

安装 Git 并验证版本

学习目标

完成本课后,你将能够:

  • 在主流操作系统安装 Git
  • 使用命令确认 Git 可执行文件和版本
  • 识别终端找不到 Git 的常见原因

核心原理

终端执行命令时会按照环境变量 PATH 中的目录顺序查找可执行文件。安装 Git 后若旧终端仍提示命令不存在,常见原因是终端没有重新加载环境变量,或 Git 的安装目录未加入 PATH。

Git 2.x 的不同小版本在部分命令和默认行为上存在差异,例如 git switch 是较新的分支切换命令。团队应记录最低支持版本,并在自动化环境中执行版本检查,避免开发机和 CI 使用差异过大的版本。

基础用法

Windows 通常安装 Git for Windows,并使用 Git Bash、PowerShell 或 Windows Terminal;macOS 可通过 Xcode Command Line Tools 或 Homebrew 安装;Debian/Ubuntu 使用 apt,Fedora/RHEL 系使用 dnf。安装命令会改变系统软件,执行前应确认具有相应权限。完成安装后,关闭并重新打开终端再验证。

完整可运行示例

以下命令使用 Bash 语法,并在独立测试目录中执行。示例会设置仓库级身份,不会修改正式项目;提交哈希、默认分支名和绝对路径等动态值以占位符表示,实际输出可能不同。

bash
git --version
printf "exec path: "
git --exec-path
printf "binary: "
command -v git

预期输出

text
git version <GIT_VERSION>
exec path: <GIT_EXEC_PATH>
binary: <GIT_BINARY_PATH>

Tips

  • 项目文档中记录最低 Git 版本,并在新成员环境检查清单中加入 git --version。
  • 不要仅凭桌面图标判断安装成功,命令行验证才是后续课程的真实前置条件。
  • 升级 Git 前先查看团队脚本是否依赖旧版本行为。

常见错误

1. 终端提示 command not found

  • 错误表现:安装完成后立即在旧终端执行命令。
  • 正确处理:重新打开终端;仍失败时检查 Git 安装目录是否在 PATH 中。

2. 调用了错误版本

  • 错误表现:系统同时存在多个 Git,输出版本与预期不符。
  • 正确处理:使用 command -v git 或 Windows 的 where git 确认路径,再调整 PATH 顺序。

本课练习

1. 完成版本验证

  • 任务目标:完成版本验证。
  • 输入或初始条件:在自己的操作系统安装 Git。
  • 实现要求:记录版本号和可执行文件路径。
  • 验收条件:git --version 与路径查询命令都能正常返回。

2. 检查终端刷新

  • 任务目标:检查终端刷新。
  • 输入或初始条件:保持一个安装前已打开的终端。
  • 实现要求:比较旧终端和新终端的命令识别结果。
  • 验收条件:能够解释环境变量加载时机。

3. 制定团队版本要求

  • 任务目标:制定团队版本要求。
  • 输入或初始条件:假设项目依赖 git switch。
  • 实现要求:查明本机是否支持并写出环境检查步骤。
  • 验收条件:检查步骤可以在新机器上重复执行。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

安装 Git 并验证版本

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通