用 Homebrew 在 macOS 上安装 Git 并完成初始化共三步:先检查或安装 Homebrew(brew --version 或执行官方安装命令),再用 brew install git 安装并 brew link git --overwrite 强制链接,最后配置用户名、邮箱、凭证助手及全局忽略文件。
用 homebrew 在 macos 上安装 git 并完成初始化,其实就三步:装好 homebrew、装 git、配好身份和基础设置。关键不是“装上”,而是确保你用的是新版 git(不是系统自带那个老版本),并且提交能被远程平台(比如 github)正确识别。
确认或安装 Homebrew
Homebrew 是前提。打开终端,先检查是否已装:
- 运行 brew --version,如果有输出(比如 Homebrew 4.3.5),说明已就位
- 如果提示 command not found,就执行安装命令:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 安装完成后,建议立即运行 brew update 更新软件源
安装并验证 Git
别跳过路径检查——很多人装完却还在用系统旧版 Git。
- 执行 brew install git
- 强制链接新版本:brew link git --overwrite(这步确保终端优先调用 Homebrew 安装的 Git)
- 重载 shell 配置:source ~/.zshrc(M1/M2 Mac 默认)或 source ~/.bash_profile(Intel 旧机型)
- 验证是否生效:
– 运行 which git,应输出 /opt/homebrew/bin/git(Apple Silicon)或 /usr/local/bin/git(Intel)
– 运行 git --version,当前稳定版应 ≥ 2.53.0 - 如果 which git 还是 /usr/bin/git,说明没生效,重启终端再试一次 source
完成基础初始化配置
这步不能省,否则每次 commit 都会报错或显示匿名作者。
- 设置全局用户名:git config --global user.name "Your Name"
- 设置全局邮箱:git config --global user.email "you@example.com"(建议用 GitHub/GitLab 注册邮箱)
- 启用密码自动记住(避免每次 push 输密码):git config --global credential.helper osxkeychain
- 查看全部生效配置:git config --global --list,确认看到 name、email 和 credential.helper 三项
可选但推荐:配置全局忽略文件
防止把临时文件、编辑器缓存等误提交。
- 创建全局忽略文件:touch ~/.gitignore_global
- 添加常用忽略项,例如:
echo "*.DS_Store\n*.log\nnode_modules/\n.env" >> ~/.gitignore_global - 让 Git 全局生效:git config --global core.excludesfile ~/.gitignore_global


















