mac上安装git并配置ssh密钥只需三步:安装git(推荐homebrew或官网安装包)、配置全局用户名和邮箱(git config --global)、生成ed25519 ssh密钥并添加至github/gitee。全程终端操作,5分钟内完成。
mac 上安装 git 并配置 ssh 密钥,核心就三件事:装好 git、设好身份、连上远程仓库。整个过程不依赖图形界面,全部在终端完成,5 分钟内可跑通。
安装 Git(两种可靠方式)
macOS 不预装 Git,需手动安装。推荐用 Homebrew,它后续升级维护更省心;官网安装包则适合不想装额外工具的用户。
- 先检查是否已装:
git --version。若提示command not found,说明还没装。 - 如果没装 Homebrew,运行这行命令安装:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 装完 Homebrew 后,执行:
brew install git - 替代方案:访问 git-scm.com/download/mac 下载 .pkg 文件,双击安装即可。
配置用户名和邮箱(必须做)
Git 每次提交都需要绑定身份,否则记录会显示为 “unknown” 或被平台拒绝。这个设置是全局的,只做一次,所有本地仓库都生效。
- 设置姓名:
git config --global user.name "Your Name"(引号内填真实名或常用昵称) - 设置邮箱:
git config --global user.email "you@example.com"(必须和 GitHub/Gitee 账号注册邮箱完全一致) - 验证是否成功:
git config --list,看到user.name和user.email行就说明写进去了。
生成并添加 SSH 密钥(免密登录关键)
SSH 密钥让你不用每次 push/pull 都输账号密码。现代 macOS(Monterey 及更新)默认支持 Ed25519 算法,安全性高、速度快,优先用它。
- 先看有没有旧密钥:
ls -al ~/.ssh。如果有id_ed25519.pub或id_rsa.pub,可跳过生成步骤。 - 生成新密钥(推荐):
ssh-keygen -t ed25519 -C "you@example.com",邮箱要和上面git config里的一致。 - 回车接受默认路径(
~/.ssh/id_ed25519),然后输入并确认一个密码短语(passphrase)——建议设,能防止私钥被盗后直接滥用。 - 启动密钥代理并加载私钥:
– macOS Monterey 及更新:eval "$(ssh-agent -s)",再执行ssh-add --apple-use-keychain ~/.ssh/id_ed25519
– macOS Catalina 或更早:ssh-add -K ~/.ssh/id_ed25519
把公钥加到代码平台(最后一步)
生成的公钥(id_ed25519.pub)需要上传到 GitHub、Gitee 等平台,才算完成认证链。
- 复制公钥内容:
cat ~/.ssh/id_ed25519.pub | pbcopy(自动复制到剪贴板) - GitHub:点右上角头像 → Settings → SSH and GPG keys → New SSH key,粘贴、命名、保存。
- Gitee:右上角头像 → 个人设置 → SSH 公钥 → 新建,同样粘贴保存。
- 测试是否连通:
ssh -T git@github.com(GitHub)或ssh -T git@gitee.com(Gitee)。首次会提示确认,输入 yes;成功返回类似 “Hi xxx! You've successfully authenticated.” 就说明通了。











