mac配置git环境,核心就三步:安装git、配置用户信息、生成SSH密钥并关联远端仓库,其中SSH配置是最容易踩坑的环节。本文从零开始,覆盖macOS从Catalina到Sequoia全版本,把每一步的实操命令和验证方法讲透,让你配置完就能直接拉代码推代码,不用再到处搜报错。

检查mac上是否已有git,避免重复安装
很多mac用户在配置git之前,并不知道系统里其实已经预装了,macOS自带的Command Line Tools会附带git,但版本通常偏旧,行业共识认为,使用Homebrew安装最新版git更稳妥,因为自带版本在部分仓库操作中可能出现兼容性问题。
在mac上安装git的两种主流方式对比
mac下安装git,主流就是Homebrew和官方安装包两条路,我建议优先走Homebrew,原因是后续升级方便,卸载也干净,官方安装包适合临时使用或不想装Homebrew的场景。
| 对比项 | Homebrew安装 | 官方安装包安装 |
|---|---|---|
| 安装命令/方式 | brew install git |
下载.pkg双击运行 |
| 默认安装路径 | /opt/homebrew/bin(M系列)/usr/local/bin(Intel) | /usr/bin/git |
| 升级方式 | brew upgrade git |
手动重新下载安装包 |
| 卸载方式 | brew uninstall git |
手动删除文件或覆盖 |
如果你用的是M1/M2/M3芯片的mac,Homebrew默认路径是/opt/homebrew/bin,这个路径在后续配置环境变量时会用到。
mac配置git全局用户名和邮箱的正确顺序
装好git之后,最基础的一步就是设置全局用户信息,这个信息会写入你每一次commit的记录里,如果不设置,提交时会报错或显示unknown用户。
设置命令
git config --global user.name "你的名字" git config --global user.email "你的邮箱"
检查是否设置成功
git config --global --list
输出结果里能看到user.name和user.email就说明成功了,如果只想给某个特定仓库设置不同的用户名和邮箱,在该仓库目录下执行同样的命令但去掉--global参数即可。
有的mac用户项目里需要区分公司身份和个人身份,这个全局配置常被忽略,实际场景中,如果你在同一个mac上同时维护公司GitLab和私人GitHub仓库,建议全局配个人邮箱,公司仓库手动单独配置,避免公司代码提交显示个人邮箱。
mac配置git ssh key,解决github和gitlab连接问题
这是mac配置git中出问题最多的环节,很多用户执行git clone时遇到Permission denied (publickey)报错,根本原因就是SSH密钥没有生成或没有添加到远端平台。
第一步:生成SSH密钥
ssh-keygen -t rsa -b 4096 -C "你的邮箱"
一路回车即可,默认密钥存放在~/.ssh/id_rsa,如果你之前已经生成过密钥,会提示是否覆盖,建议不要覆盖,可以给它起个新名字id_rsa_github,多把密钥分别管理。

第二步:把公钥添加到github或gitlab
cat ~/.ssh/id_rsa.pub
登录GitHub,打开Settings -> SSH and GPG keys,点击New SSH key,粘贴保存,GitLab的操作路径是Preferences -> SSH Keys。
第三步:测试连接
ssh -T git@github.com
看到Hi username! You've successfully authenticated就说明通了,GitLab的测试命令是ssh -T git@gitlab.com。
多账户场景下的SSH config配置
如果你同时使用GitHub和GitLab,或者有多个GitHub账号,建议你在~/.ssh目录下新建config参考如下:
Host github.com HostName github.com User git IdentityFile ~/.ssh/id_rsa Host gitlab.com HostName gitlab.com User git IdentityFile ~/.ssh/id_rsa_gitlab
配好之后,git会自动根据仓库域名选择对应的密钥文件,不用每次手动切换。
mac配置git代理代理绕过策略
国内网络环境下,从GitHub push或clone经常卡在RPC failed这类上传错误上,不少用户以为是代码问题,反复重试浪费时间,实际上这是网络连接不稳定导致的。
如果你日常需要访问GitHub,建议给git设置代理,假设你的代理软件本地端口是7890:
git config --global http.proxy http://127.0.0.1:7890 git config --global https.proxy http://127.0.0.1:7890
公司内网或GitLab仓库通常不需要走代理,可以单独对某个仓库取消代理:
git config --unset http.proxy git config --unset https.proxy
不建议在全局配置代理后忘掉它,否则你访问公司内网GitLab时会出现长时间等待后超时的情况,最稳妥的做法是只给走代理困难的仓库单独设置代理,全局保持干净。

mac配置git时常见报错的排查思路
一次性把所有配置全做对的人很少,多数报错集中在几个固定点上,下面按频率从高到低梳理。
xcrun: error: invalid active developer path:说明macOS的开发者工具没装完整,执行xcode-select --install安装即可,装完git就能用了。Permission denied (publickey):SSH密钥没有命中,先确认密钥在~/.ssh目录里,再确认公钥已经粘贴到GitHub或GitLab后台,最后用ssh -T测试。fatal: Not a git repository:当前目录不是git仓库,检查是否执行过git init,或者是否克隆过仓库。fatal: unable to access...Failed to connect to github.com port 443:网络问题,参考上文代理配置,或者检查代理软件是否开启。
检查mac配置git是否成功的完整验证流程
配置完不要急着走人,全部执行一遍下面的验证命令,确保万无一失。
git --version git config --global --list ssh -T git@github.com
这三条命令分别验证git本体、用户配置、SSH连接,三条都通过,你的mac git配置就算完成了,如果这三步通过了仍拉不到代码,大概率是仓库权限或远端地址问题,可以用git remote -v查看远端地址是否写错,比如把HTTPS地址写在SSH配置下,或者在GitLab私有项目上没有获得授权。
常见疑问解答
mac配置git环境需要多久?
熟练操作的情况下3到5分钟就能完成,多数时间花在生成密钥和粘贴公钥上,如果你卡在报错上,请对照上面的排查列表逐项检查。
mac配置git用Homebrew还是官方包?
推荐Homebrew,原因有三:后续升级方便、环境变量配置更可控、与其他开发工具(如Node.js、Python)的安装方式保持一致,官方包更像是应急方案。
mac配置git报错xcrun invalid developer path怎么解决?
运行xcode-select --install安装Command Line Tools,如果之前装过Xcode,也可能是因为路径被改动,可以尝试sudo xcode-select --reset重置路径。
mac git配置这件事,本质上是给git装好、告诉它你是谁、再给它一把连接远端仓库的钥匙,按本文顺序操作一遍,拉一个新仓库试试手,你的mac开发环境就正式踏出第一步了。
