Mac安装Git需先确认是否预装(git --version),未安装则用Homebrew执行brew install git;必须补装Xcode命令行工具(xcode-select --install);再配置全局用户名和邮箱(git config --global user.name/user.email),并验证(git config --list | grep user)。

Mac电脑上安装Git并配置全局用户名和邮箱,是开始使用版本控制前必须完成的两步基础操作,缺一不可——没有Git就无法执行任何版本命令,没配用户名和邮箱则后续每次提交都会报错或留空作者信息。
确认系统是否已预装Git
打开终端(Terminal),输入:git --version → 回车。
如果返回类似 git version 2.40.1 的结果,说明系统已自带Git,可跳过安装步骤;若提示 command not found: git,则需手动安装。
注意:macOS自10.15 Catalina起不再默认包含完整Git工具链,即使显示版本号,也可能缺少xcrun等关键组件,后续遇到路径错误时仍需补装开发者工具。
安装Git(推荐Homebrew方式)
先检查是否已安装Homebrew:终端中运行 brew --version。未安装则执行:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安装完成后,运行:brew install git → 等待下载编译完成。
这一步会把Git安装到/opt/homebrew/bin/git(Apple Silicon)或/usr/local/bin/git(Intel),并自动加入PATH,无需手动配置环境变量。
补装Xcode命令行工具(关键前置)
运行:xcode-select --install → 弹出图形窗口后点击“安装” → 等待完成。
【必须执行】 否则后续使用git clone或ssh连接远程仓库时,极大概率触发xcrun: error: invalid active developer path错误,导致所有网络操作中断。
配置全局用户名和邮箱
第一步:设置姓名git config --global user.name "张三"
第二步:设置邮箱git config --global user.email "zhangsan@example.com"
第三步:验证是否写入成功git config --list | grep user → 应输出两行,分别含user.name和user.email。
⚠️ 邮箱必须与GitHub/Gitee等平台注册邮箱完全一致,否则提交记录无法关联到你的个人主页;用户名可任意填写,但建议用真实中文名或常用ID,便于团队识别。
检查SSH密钥(为后续推送做准备)
方法一:快速生成ED25519密钥(推荐)ssh-keygen -t ed25519 -C "zhangsan@example.com" → 连续回车使用默认路径和空密码。
方法二:兼容旧平台的RSA密钥ssh-keygen -t rsa -b 4096 -C "zhangsan@example.com"
生成后,公钥文件位于~/.ssh/id_ed25519.pub或~/.ssh/id_rsa.pub,用cat ~/.ssh/id_ed25519.pub查看内容,复制整段(从ssh-ed25519开头到邮箱结尾),粘贴到GitHub/Gitee的SSH Keys设置页即可。


















