如何复用现有SSH密钥向GitHub推送代码及排障求助

• 确认本地密钥存在：执行ls ~/.ssh/，检查是否有已生成的SSH密钥文件（通常为id_rsa私钥和id_rsa.pub公钥，若为自定义命名需对应）
• 验证GitHub公钥配置：登录GitHub账户，进入「Settings」→「SSH and GPG keys」，确认已添加的公钥内容与本地cat ~/.ssh/id_rsa.pub的输出完全一致
• 切换仓库远程地址为SSH格式：
  1. 先查看当前远程地址：git remote -v
  2. 若显示为HTTPS开头（如https://github.com/用户名/仓库名.git），执行命令切换为SSH地址：git remote set-url origin git@github.com:用户名/仓库名.git
• 测试SSH连接：执行ssh -T git@github.com，成功时会返回「Hi 用户名! You've successfully authenticated, but GitHub does not provide shell access.」
• 执行推送：直接运行git push origin 目标分支名，若密钥设置了密码，首次会提示输入，后续由ssh-agent缓存后无需重复输入

核心排查点1：远程仓库地址是否为SSH格式 #

如果当前远程地址是HTTPS，Git会默认调用GitHub用户名密码验证，而非SSH密钥。务必通过git remote -v确认地址为git@github.com:xxx/xxx.git格式，若不是则按上述流程切换。

核心排查点2：SSH密钥的加载与权限 #

• 检查ssh-agent是否已加载密钥：执行ssh-add -l，若未显示你的密钥，重新执行：

  eval "$(ssh-agent -s)"
  ssh-add ~/.ssh/id_rsa  # 替换为你的私钥文件路径
  

• 修复密钥文件权限：SSH对权限要求严格，执行以下命令确保权限正确：

  chmod 600 ~/.ssh/id_rsa
  chmod 644 ~/.ssh/id_rsa.pub
  

核心排查点3：SSH配置文件优化 #

在~/.ssh/config中添加以下配置，强制指定连接GitHub时使用的密钥，避免自动匹配错误：

Host github.com
  HostName github.com
  User git
  IdentityFile ~/.ssh/id_rsa
  IdentitiesOnly yes

核心排查点4：Git凭据助手干扰 #

若之前使用HTTPS时配置了Git凭据助手，可能导致验证逻辑混乱：

• 查看当前凭据助手设置：git config --global credential.helper
• 暂时禁用：git config --global --unset credential.helper，再尝试推送测试

核心排查点5：公钥有效性验证 #

重新核对GitHub上的公钥与本地公钥内容，确保无多余空格、换行或字符错误。可重新复制本地公钥内容（cat ~/.ssh/id_rsa.pub），在GitHub上重新添加并测试连接。

内容的提问来源于stack exchange，提问作者Teja Sruthi Varanasi