Mac Git 与 GitHub 完整配置教程

从零开始，一站式完成 Mac 上 Git 安装、SSH 密钥生成、GitHub 账号绑定。

准备工作

确认 Git 已安装

hljs bash
git --version
# 输出类似 git version 2.45.1

若未安装，通过 Homebrew 安装（推荐）：

hljs bash
brew install git

配置 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"

配置 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 将密钥保存到系统钥匙串，重启终端不失效。

将公钥添加到 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

常见问题