为什么需要在Mac上配置Git
Git是目前最主流的代码版本控制工具，无论是个人独立开发还是团队协同作业，都离不开它。macOS系统虽然内置了部分开发环境，但完整的Git工作流需要手动完成身份绑定和密钥配置。掌握这套流程后，你可以无缝连接GitHub、Gitee或企业内部仓库，彻底告别繁琐的账号密码输入，提升日常编码效率。正确的初始配置能够避免后续出现权限报错和提交记录缺失的问题。
检查系统是否自带Git
打开终端应用程序，直接在启动台搜索Terminal即可启动。在命令行中输入git version并回车。如果屏幕返回类似git version 2.39.2的信息，说明系统已经预装了Git，你可以跳过安装步骤直接进入配置环节。如果提示command not found，则需要手动补装。对于大多数新系统，只需运行一次xcode-select --install命令，系统就会自动下载并配置好基础的Git环境，整个过程无需额外下载大型安装包，兼容性也最好。
通过命令行工具或Homebrew安装Git
如果你习惯使用包管理器，或者需要获取最新版本的Git，推荐使用Homebrew。先确保你的Mac已经安装了Homebrew，然后在终端执行brew install git。安装完成后再次输入git version验证。这种方式的优势在于后续可以通过brew upgrade一键升级，避免频繁手动下载压缩包替换文件。国内用户如果遇到网络慢的问题，可以临时切换镜像源，或者直接采用系统自带的Xcode命令行工具方案，稳定性更高且不容易出现依赖冲突。
设置基础身份信息
每次提交代码时，Git都会记录作者名称和邮箱。这一步必须配置，否则无法生成有效的提交记录。在终端中依次执行两条命令，将yourname替换为你的真实姓名或昵称，youremail替换为你注册代码托管平台的邮箱地址。配置范围分为全局和本地，全局生效于当前用户的所有项目，本地仅针对特定仓库。建议优先使用全局配置，执行git config --global user.name yourname和git config --global user.email youremail即可。配置完成后可以用git config --list查看已保存的参数，确保信息准确无误且没有拼写错误。
生成并配置SSH密钥
为了避免每次推送代码都输入用户名和密码，SSH密钥是最稳妥的方案。首先检查.ssh目录下是否已有id_rsa和id_rsa.pub文件，如果有可以直接复用。如果没有，运行ssh-keygen -t ed25519 -C youremail一路按回车确认，系统会在默认路径生成公私钥对。接着使用pbcopy < ~/.ssh/id_ed25519.pub将公钥内容复制到剪贴板。打开你的GitHub或GitLab账户设置，找到SSH Keys选项，粘贴公钥并保存。最后回到终端输入ssh -T git@github.com进行测试，看到Hi开头的欢迎语即表示配置成功。遇到权限拒绝时，请检查.ssh目录下的config文件是否添加了Host和IdentityFile参数。
常用命令与日常开发流程
配置完毕后就可以开始实际工作了。进入项目文件夹后运行git init初始化仓库。修改代码后使用git status查看变动状态，接着用git add .将文件加入暂存区。随后执行git commit -m 描述本次修改内容完成快照记录。如果需要远程同步，先运行git remote add origin 仓库地址绑定远端，再用git push -u origin main推送首次分支。日常拉取更新直接使用git pull，合并冲突时可使用git merge处理。养成小步提交的习惯，配合清晰的注释，能大幅降低后期维护成本。定期使用git log查看历史节点，有助于快速定位问题代码。
常见问题排查建议
开发者在配置过程中经常遇到行尾符不一致导致的警告，可以在终端输入git config --global core.autocrlf input来统一处理。如果推送速度极慢，多半是DNS解析问题，可尝试更换代理或修改hosts文件。遇到权限拒绝时，检查.git/config里的url是否正确，以及SSH密钥是否真正关联到了平台账户。Mac系统更新后偶尔会重置Git环境变量，若发现命令失效，重新运行xcode-select --install通常能恢复。保持终端窗口干净，定期清理不需要的缓存分支，能让工作流始终顺畅。遇到疑难杂症时，直接访问官方文档查阅具体报错代码，往往比盲目搜索更高效。
