git push 报 Permission denied (publickey) 怎么解决

现象:仓库地址没错,就是推不上去

本地提交都正常,执行 git push 时终端输出 git@github.com: Permission denied (publickey). fatal: Could not read from remote repository。换成别人电脑同样的仓库地址就能推,说明不是权限或仓库配置的问题。

原因:SSH 这一层没认出来

  • 本机没有密钥,或者生成在别的用户目录下,比如用 root 操作但密钥在普通用户里。
  • 密钥没加载进 ssh-agent,每次连接都找不到可用的身份。
  • 公钥没上传,或者复制时漏了开头结尾,平台侧校验不通过。
  • 22 端口不通,网络层直接超时,报错却被误读成鉴权失败。
  • 同一台机器上有多把密钥,SSH 拿错了那把。

解决步骤

第一步,打开详细日志看它到底在试哪个密钥:

ssh -vT git@github.com
ssh-add -l

日志里出现 Offering public key 但随后被拒,说明密钥存在但服务端不认;如果一行都没有,说明本机压根没找到密钥。

第二步,生成并加载密钥,然后确认公钥内容完整:

ssh-keygen -t ed25519 -C "you@example.com"
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519
cat ~/.ssh/id_ed25519.pub

第三步,把公钥贴到代码平台,内容从 ssh-ed25519 开头到邮箱结尾,一行不能断。

第四步,用配置文件指定身份,多密钥场景避免拿错:

Host github.com
    HostName ssh.github.com
    Port 443
    User git
    IdentityFile ~/.ssh/id_ed25519

顺带把端口改成 443,能绕开 22 端口被限制的网络。

第五步,检查权限。私钥必须是 600,目录 700,权限过宽 SSH 会直接忽略这个文件,且日志里只给一句含糊的提示。

小结

先用 ssh -vT 判断是"没找到密钥"还是"服务端拒绝",再决定是补公钥还是加配置。多密钥环境建议统一写在 Config 里,比临时敲命令可靠。

另外两个常见误判:一是地址栏里的 remote 用的是 https 而不是 git@,这种情况下 SSH 密钥根本不参与鉴权,报的是账号密码错误,用 git remote -v 先确认协议;二是首次连接时的 Are you sure you want to continue connecting 提示,在脚本里被自动拒绝后同样表现为 publickey 失败,检查 known_hosts 里是否已有对应记录。把这两点排除掉,剩下的基本就是密钥本身的问题。

您可以还会对下面的文章感兴趣: