Homebrew安装Git后终端找不到命令是因为其路径未加入$PATH;需将/opt/homebrew/bin(M1/M2)或/usr/local/bin(Intel)添加到shell配置文件并重载,再执行git --version验证。

Homebrew安装Git后为什么终端还找不到git命令
Mac自带的系统路径(比如/usr/bin)里有个老旧的git,但Homebrew装的在/opt/homebrew/bin/git(Apple Silicon)或/usr/local/bin/git(Intel),没加进$PATH就根本执行不到。
实操建议:
- 确认Homebrew是否已正确安装:运行
brew --version,有输出才算到位 - 检查Git是否已通过brew安装:
brew list | grep git - 把Homebrew的bin路径加到shell配置里——M1/M2用
~/.zshrc,Intel老机器可能还是~/.bash_profile;加这行:export PATH="/opt/homebrew/bin:$PATH"(M1/M2)或export PATH="/usr/local/bin:$PATH"(Intel) - 重载配置:
source ~/.zshrc(或对应文件),再试git --version
配置用户信息时git config --global不生效
常见现象是提交后git log里作者邮箱显示为yourname@MacBook-Pro.local,说明全局配置压根没写进去,或者被项目级配置覆盖了。
实操建议:
- 先查当前生效的用户名和邮箱:
git config user.name和git config user.email(不带--global,看实际生效值) - 写入全局配置必须加
--global,且用户名/邮箱不能为空:git config --global user.name "Your Name"、git config --global user.email "you@example.com" - 如果当前目录下有
.git/config,它会覆盖全局配置;删掉里面的[user]段,或确认它没写错字段名(比如写成email而不是user.email) - 别用中文引号、全角空格,复制命令时容易混进去
SSH密钥生成后git clone仍提示Permission denied (publickey)
这是最常卡住新手的一环:密钥生成了、GitHub也加了公钥,但git@github.com:xxx/yyy.git还是连不上,本质是SSH agent没加载密钥,或Git没走SSH协议。
实操建议:
- 生成密钥时指定ED25519算法(更安全):
ssh-keygen -t ed25519 -C "you@example.com" - 启动SSH agent并添加密钥:
eval "$(ssh-agent -s)",然后ssh-add ~/.ssh/id_ed25519 - 测试连接:
ssh -T git@github.com,看到Hi XXX!才算通 - 确保clone用的是SSH地址(以
git@github.com:开头),不是HTTPS地址;HTTPS地址不会走SSH密钥认证 - 如果公司GitLab自建服务,注意端口可能不是22,需在
~/.ssh/config里显式配置Port和IdentityFile
每次push都要输密码?Git凭证管理怎么设才不踩坑
用HTTPS克隆仓库时,默认每次push都弹窗输密码(或个人访问令牌PAT),既烦又不安全。macOS Keychain本可自动存,但默认不启用,或被旧配置干扰。
实操建议:
- 启用Git内置的osxkeychain辅助工具:
git config --global credential.helper osxkeychain - 如果之前输错多次导致Keychain里存了错误凭据,去“钥匙串访问”App里搜
github.com或gitlab.com,删掉对应条目再试一次push - GitHub现在强制用PAT代替密码,生成PAT时务必勾选
repo权限;GitLab类似,选api+write_repository - 别把PAT硬编码在URL里(如
https://token@github.com/xxx/yyy.git),既不安全又容易泄露到日志或git remote -v输出中
Git在Mac上真正跑顺的关键,不在装得多快,而在路径、协议、凭据这三层有没有对齐。任何一个环节断了,都会表现为“明明按教程做了却不行”。尤其注意Shell配置文件类型、SSH密钥加载状态、以及HTTPS/PAT的配合方式——这些地方一错,后面所有操作都像在雾里推门。


















