版本控制与协作 / 系统课时
安装 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。 - 实现要求:查明本机是否支持并写出环境检查步骤。
- 验收条件:检查步骤可以在新机器上重复执行。
按自己的节奏,确认真正理解。