Git SSH Key 配置

用 SSH 方式操作 Git 仓库，好处是不用每次 push/pull 都输入账号密码，也更便于在 CI 脚本里自动化。这篇把从配置用户信息、生成密钥、上传公钥到验证连通的完整过程记一遍，顺带列出几个常见失败原因。

一、前置条件

• 本机已装 Git（Windows 可用 Git Bash，macOS/Linux 用系统终端）。
• 已有 GitHub 或 Gitee 账号。

二、配置提交身份

提交代码时会把用户名和邮箱写进提交记录，先保证跟代码平台一致：

git config --global user.name "你的用户名"
git config --global user.email "[email protected]"

# 查看已有配置
git config --list

这些信息落在 ~/.gitconfig 里。

三、生成 SSH Key

ssh-keygen -t rsa -b 4096 -C "[email protected]"

一路回车即可（也可以顺便设个 passphrase）。看到类似下图的 ASCII 艺术图案就说明生成成功：

+---[RSA 4096]----+
|        .o+*+oo. |
|       .=+*o.    |
|      ++.*o      |
|     .B.+.       |
|    =o.S         |
|  ++o.           |
| .+=.            |
|\ .*o            |
| .o.E.           |
+---[SHA256]------+

生成的文件默认在 ~/.ssh/ 下：id_rsa 是私钥，id_rsa.pub 是公钥。

四、复制公钥

cat ~/.ssh/id_rsa.pub

把输出的全部内容（以 ssh-rsa 开头、以你的邮箱结尾）复制下来。

五、把公钥加到代码平台

• GitHub：Settings → SSH and GPG keys → New SSH key → 填标题（比如 MacBook Pro）→ 粘贴公钥 → Add SSH key。
• Gitee：设置 → SSH 公钥 → 填标题 → 粘贴公钥 → 添加。

六、验证连通

ssh -T [email protected]
ssh -T [email protected]

成功时控制台会显示类似 Hi xxx! You've successfully authenticated 的提示。

七、日常仓库操作

# 用 SSH 地址克隆
git clone [email protected]:用户名/仓库名.git

# 已有仓库改成 SSH 地址
git remote set-url origin [email protected]:用户名/仓库名.git

八、连不上时怎么查

• 先查公钥有没有加对：回平台 SSH 公钥页面确认内容完整、没有多余换行。
• 确认用的是 SSH 地址：SSH 形式是 git@host:user/repo.git，HTTPS 形式是 https://host/user/repo.git，两者不能混用。
• 用 verbose 看过程：ssh -vT [email protected]，能看到卡在哪一步。
• 权限问题：私钥权限太开会被拒绝，chmod 600 ~/.ssh/id_rsa。

九、密钥安全

• 私钥 id_rsa 绝对不能外传，也不要提交进仓库。
• 设备丢失或怀疑泄露，立刻去平台删除对应公钥并重新生成。
• 定期轮换密钥，长尾机器上的公钥尤其建议清一遍。

把这几步走顺之后，日常 git push/git pull 就是完全免密了。

qidao123.com企服评测-应用市场 编辑提示：本文为 Git SSH Key 配置流程整理，密钥文件请自行妥善保管，平台端操作入口可能随版本调整。