Mac Git 与 GitHub 完整配置教程

换 Mac 后重新配置 Git/GitHub 的备忘。

检查 Git

hljs bash
git --version
# git version 2.45.1 这种就行

没有的话用 Homebrew 装：

hljs bash
brew install git

基础配置

Git 靠用户名和邮箱标记提交，建议与 GitHub 一致，避免提交记录对不上。

hljs bash
git config --global user.name "你的GitHub用户名"
git config --global user.email "你的GitHub邮箱@example.com"

检查：

hljs bash
git config --global --list

单个仓库用不同身份

工作项目和个人项目分开的话，进仓库目录单独设：

hljs bash
cd /path/to/work-repo
git config user.name "工作专用用户名"
git config user.email "工作邮箱@company.com"

没有 --global，只对当前仓库生效。

SSH 密钥

检查现有密钥

hljs bash
ls -la ~/.ssh

如果已经有 id_ed25519 和 id_ed25519.pub，直接跳到添加公钥那一步。

生成

hljs bash
ssh-keygen -t ed25519 -C "你的GitHub邮箱@example.com"

一路回车，默认路径即可。

加到 ssh-agent

hljs bash
eval "$(ssh-agent -s)"
ssh-add --apple-use-keychain ~/.ssh/id_ed25519

--apple-use-keychain 需要加上，否则重启终端后得重新 ssh-add。

公钥贴到 GitHub

hljs bash
cat ~/.ssh/id_ed25519.pub

复制那串字符 → GitHub Settings → SSH and GPG keys → New SSH key → 贴进去。

验证

hljs bash
ssh -T git@github.com

看到 Hi 用户名! You've successfully authenticated... 即完成。

HTTPS 凭证

hljs bash
git config --global credential.helper osxkeychain

HTTPS 克隆时密码会存进系统钥匙串，不用每次都输。

常见问题