Mac 怎么安装 Git 2.55？2026 新手教程

先打开 Terminal

在 macOS 中，你可以打开 Launchpad，搜索 Terminal；也可以在 Finder 的“应用程序 → 实用工具”中找到它。Terminal 就像一间可以直接给 Mac 下达命令的教室，命令是口令，PATH 则像路线表，决定系统去哪里寻找 git。Apple Terminal 官方指南

打开窗口后，依次运行：

git --version
command -v git

git --version 会显示当前 Git 版本，command -v git 会显示终端实际找到的可执行文件位置。Git 版本命令说明

你可能看到三种结果：

• ✅ 显示版本和路径：先不要安装，进入课程要求判断。
• ⚠️ 弹出开发工具安装提示：说明系统正在请求 Xcode Command Line Tools，按课程允许的方式继续。
• ❌ 提示找不到命令：先完成开发工具安装，再重新打开 Terminal 检查。

如果课程只要求你初始化仓库、提交作业和查看历史，已有可用 Git 往往已经够用。不要把“没有显示 2.55.0”直接等同于“完全不能学习”。

对照课程要求

把版本检查想成检查书包里有没有教材：

• 课程说明只写“使用 Git”：保留当前可用版本。
• 教师或工具明确要求 Git 2.55：再确认终端输出是否满足要求。
• VS Code 能打开项目，但源代码管理面板报错：重点检查 Git 路径，不要只重装 VS Code。
• 项目依赖或自动化脚本明确要求新版本：记录当前版本，再选择 Homebrew 路线。

VS Code 的 Git 功能依赖 Mac 上实际安装的 Git，而不是单独安装一个编辑器插件。它会调用机器中的 Git 来完成暂存、提交和查看差异。VS Code 源代码管理说明

Mac 上常见的两条路线不是“哪个绝对更好”，而是适合的学习阶段不同。

路线一：Xcode Command Line Tools

对零基础学生来说，这是默认路线。Git 官方 macOS 页面明确列出 Apple 提供的 Xcode Command Line Tools 安装方式：

xcode-select --install

系统弹窗出现后，确认安装。安装结束并不代表验收完成，你还要关闭当前 Terminal 窗口，重新打开一个窗口，再运行：

git --version
command -v git

如果两个命令都有输出，说明终端已经能找到 Git。此时进入身份配置，不要为了追求某个小版本号再次安装。

这条路线的优势是步骤少，适合完成课程作业。它的限制是：实际获得的版本要以你的终端结果为准，不能把 Git 官方页面显示的最新版本当成所有 Mac 都会自动得到的版本。

路线二：Homebrew

如果课程明确要求 Git 2.55，或者你已经用 Homebrew 维护 Python、Node.js 等工具，可以考虑：

brew install git

安装完成后立即检查：

git --version
command -v git

重点看两件事：

• 版本是否符合课程或工具要求。
• 终端调用的路径是否已经切换到你预期的位置。

如果 brew install git 执行结束，但 command -v git 仍显示另一条路径，不要继续重复执行安装命令。这通常是“安装位置”和“终端路线表”没有统一。先记录两个命令的输出，再检查当前 shell 的 PATH 配置。

不建议新手从源码编译 Git。源码编译会额外引入编译器、依赖和路径管理问题，对“完成课程提交”没有直接帮助。Git 官方安装页也把 Homebrew、MacPorts 和 Xcode Command Line Tools 列为 macOS 的安装路线，同时提醒非源码发行包可能由第三方提供。

安装 Git 只是拿到工具。提交作业前，还要告诉 Git“这次提交是谁做的”。

设置提交身份

运行：

git config --global user.name "你的姓名或昵称"
git config --global user.email "你的编程邮箱"
git config --global init.defaultBranch main

然后检查：

git config --global --list

Git 官方文档说明，用户名和邮箱会写入你创建的提交记录；使用 --global 后，这台 Mac 上的大多数仓库都会使用这组设置。Pro Git 首次配置

你不必公开私人邮箱。可以使用课程允许的昵称，或专门用于编程项目的邮箱。关键是保持提交记录可识别，并遵守老师或代码托管平台的要求。

注意，Git 身份配置不等于登录代码托管平台：

• user.name 和 user.email：写入提交记录。
• HTTPS、SSH：连接远程仓库的方式。
• 密码、访问令牌、SSH 私钥：认证凭证，不能写进代码或发给别人。

如果你使用 HTTPS 推送，平台可能要求访问令牌而不是账号密码；如果使用 SSH，则需要在当前 Mac 上配置对应密钥。GitHub 官方文档列出的命令行认证方式包括个人访问令牌和 SSH 密钥。认证方式说明

不要把以下内容粘贴到作业仓库：

密码
个人访问令牌
SSH 私钥
浏览器导出的登录 Cookie

如果你是在临时远程 Mac 上学习，尤其要避免保存长期有效的凭证。课程结束后，应退出账号，并根据平台设置撤销不再使用的令牌。个人访问令牌使用说明

不要直接拿正式课程项目做第一次实验。先建立一个可以删除的小文件夹，用它验证 Git 环境。

创建练习仓库

mkdir -p ~/git-test
cd ~/git-test
printf "# Git Test\n" > README.md
git init
git status

git init 会在当前目录建立 .git 文件夹，但此时还没有任何文件进入提交历史。你可以把它理解成先准备一本作业本，之后还要把文件放进“待提交区”，再创建存档点。Pro Git 仓库基础

继续运行：

git add README.md
git status
git commit -m "first test commit"
git log --oneline -1

验收时不要只看最后一句有没有报错。你要确认：

• git status 能识别 README.md。
• git commit 没有提示缺少用户名或邮箱。
• git log --oneline -1 能显示刚才的提交。
• 修改 README.md 后，git diff 能看到具体变化。

可以再做一次修改：

printf "\nGit is ready.\n" >> README.md
git diff
git add README.md
git commit -m "update readme"
git log --oneline

这样你验证的不只是版本号，还验证了 Git 能否完成“修改、查看差异、提交、查看历史”的完整流程。

接入 VS Code

在 VS Code 中打开 git-test 文件夹。由于该目录已经包含 .git，编辑器应能识别它是 Git 仓库，并在源代码管理视图中显示文件变化。VS Code 官方说明，它可以直接调用本机 Git 完成暂存、提交和差异查看。VS Code 快速入门

如果面板仍提示找不到 Git：

1. 在 VS Code 中打开命令面板。
2. 运行“Git：显示 Git 输出”。
3. 查看它调用的 Git 可执行文件路径。
4. 回到 Terminal，对照 command -v git 的结果。
5. 完全退出并重新打开 VS Code。

VS Code 官方排错文档也建议查看 Git 输出窗口，因为那里会记录实际调用的可执行文件、命令和错误信息。VS Code Git 排错说明

完成测试仓库后，再把正式课程项目接入 Git。建议按下面的顺序操作：

• ✅ 先查看课程要求，不要自动升级。
• ✅ 在项目目录运行 git status。
• ✅ 配置或确认提交用户名与邮箱。
• ✅ 首次提交前查看 git diff。
• ✅ 提交后用 git log 检查历史。
• ✅ 按课程要求推送到授权的远程仓库。
• ✅ 额外保留一份本地压缩包或课程允许的备份。
• ❌ 不要把密码、令牌和私钥放进仓库。
• ❌ 不要在没有确认权限的情况下推送学校项目。
• ❌ 不要把整个用户目录直接初始化成 Git 仓库。

本地 Mac 和远程 Mac 的差别，主要不在 Git 命令，而在项目保存位置。远程 Mac 到期后，你可能失去对远程磁盘的访问权限。因此，正式项目至少要完成一次远程仓库同步，并确认另一台设备能够重新克隆或打开项目。

如果当前电脑不允许安装 Git 或开发工具，不要尝试修改受保护目录，也不要运行来源不明的安装脚本。你可以先询问课程管理员，确认是否允许使用远程 Mac、学校提供的开发环境或其他授权设备。

在开始正式课程前，逐项勾选：

• [ ] git --version 能返回版本。
• [ ] command -v git 能返回实际路径。
• [ ] 你知道当前 Git 来自 Xcode Command Line Tools 还是 Homebrew。
• [ ] git config --global user.name 能返回预期身份。
• [ ] git config --global user.email 能返回预期邮箱。
• [ ] 测试仓库成功完成首次提交。
• [ ] git log 能查看提交历史。
• [ ] VS Code 源代码管理面板能识别项目。
• [ ] 正式项目已经保存到授权位置。
• [ ] 远程 Mac 项目已经完成推送或导出备份。

如果前四项没有通过，不要急着处理远程仓库认证。先把本地提交流程跑通，再处理 HTTPS 或 SSH。这样排错范围更小，也不会把“Git 没安装”“身份未配置”和“远程认证失败”混成一个问题。

如果你还在整理完整的 Mac 学习环境，可以先查看 CALMVPS 的 Mac 使用入口。如果学校电脑无法安装课程工具，也可以先了解 CALMVPS 的远程 Mac 方案，但请先确认课程是否允许使用远程设备。

Mac 已经有 Git，还需要重新安装吗？

不一定。先运行 git --version 和 command -v git。如果课程没有指定版本，并且你能完成初始化、提交和查看历史，就没有必要重复安装。只有课程或开发工具明确要求较新版本时，才进入 Homebrew 路线。

两种安装方式的区别在哪里？

Xcode Command Line Tools 更适合第一次配置 Git 的学生，步骤少，适合基础作业。Homebrew 适合已经使用包管理器，或需要主动维护工具版本的人。无论选择哪条路线，都必须用终端结果验收，而不是把安装命令执行结束当成成功。

为什么安装后仍然找不到 Git？

可能是开发工具没有完成安装，也可能是当前 Terminal 或 VS Code 没有刷新环境。重新打开 Terminal，再检查 command -v git。如果 VS Code 仍报错，查看 Git 输出窗口，确认编辑器调用的路径是否和终端一致。

用户名和邮箱怎么填写？

它们用于标记提交记录，不等于代码托管平台的登录密码。你可以使用课程允许的昵称和专用邮箱，不必公开私人联系方式。设置后运行 git config --global --list 检查结果，避免把邮箱命令中的引号或拼写写错。

远程 Mac 到期前怎么保存项目？

先在项目目录完成提交，再按课程要求推送到你有权限的远程仓库。随后导出一份项目压缩包，或者使用课程允许的 Git 备份方式保存历史。最后在另一台设备验证文件能打开、提交历史存在，再结束远程 Mac 使用。

如果你现在的 Windows 电脑或学校设备不能安装课程需要的工具，常见问题不是 Git 命令本身，而是没有管理员权限、开发工具不完整、项目无法长期保存。继续反复尝试系统级安装，既可能浪费时间，也可能违反学校设备管理规则。

更稳妥的做法，是在一台拥有完整权限的远程 Mac 上重复本文流程：先检查 Git，再完成身份配置，使用一个可删除的小项目验证编辑、提交和备份，确认成功后再迁移正式作业。若你需要临时的 macOS 学习环境，可以查看 CALMVPS 的可用方案，先按课程要求和项目保存周期做选择。

最后更新于 2026 年 9 月 8 日，版本信息核实自 Git 官方 macOS 安装页；命令、配置含义、认证与编辑器行为已对照 Git、Apple、GitHub 和 VS Code 官方文档复核。