本文会先从原理层面拆解四大核心病因：从密钥生成缺失导致“无证可验”，到平台密钥未同步造成“凭证无效”，再到文件权限冲突引发“系统拒认”，以及协议不匹配形成“通道错误”。接着提供一套“手把手”解决方案：从用命令检查本地是否存在密钥文件，到生成符合规范的新SSH密钥（含ED25519等更安全算法），再到通过ssh-agent管理密钥、同步到远程平台，最后用ssh命令测试连接是否通畅。
无论你是刚接触Git的新手，还是换电脑后突然遇到报错的资深开发者，都能通过这套流程快速定位问题。亲测按步骤操作，多数情况5分钟内就能让仓库克隆恢复正常，避免因认证故障耽误开发进度。
想知道SSH连接到底通没通，其实有个特别简单的测试办法，你直接在终端里敲一行命令就行。比如你用的是GitHub，就输入ssh -T git@github.com，然后回车——这里的-T参数不用记，就理解成“跟远程服务器打个招呼但不打开完整连接”就行。如果一切顺利，终端会跳出一句“Hi [你的用户名]! You’ve successfully authenticated, but GitHub does not provide shell access”，后面那句“不提供shell访问”不用管，重点是前面的“successfully authenticated”，这就说明你本地的SSH密钥已经被GitHub认出来了，身份验证完全通过，连接妥妥的。
要是用GitLab或者Gitee也一样，把命令里的域名换成对应的就行：GitLab用户输ssh -T git@gitlab.com，Gitee用户输ssh -T git@gitee.com，成功的话都会返回带你用户名的确认信息。不过万一输完命令，终端反而跳出“Permission denied (publickey)”，那说明前面的配置肯定哪里出了岔子。这时候不用慌，先按之前说的步骤排查：是不是本地密钥压根没生成？或者生成了但没通过ssh-add添加到ssh-agent里（尤其是重启电脑后，agent可能没自动加载密钥）？再或者公钥虽然复制了，但粘贴到平台设置时不小心多了个空格、少了个字符？甚至密钥文件的权限，之前强调过必须是600（只有自己能读写），要是设成755这种太开放的，系统也会觉得不安全，直接拒绝用它来认证。顺着这些方向检查，基本都能找到问题在哪儿。
生成SSH密钥时提示“Permission denied”怎么办？
这通常是因为本地.ssh目录或密钥文件权限设置不当。需先检查~/.ssh目录权限，确保为700（仅所有者可读写执行），命令：chmod 700 ~/.ssh。若生成密钥时提示文件无法写入，可能是目标路径已存在同名文件且权限过严，可删除旧文件（如rm ~/.ssh/id_rsa）后重试，或指定新文件名（如ssh-keygen -t ed25519 -C "your_email@example.com" -f ~/.ssh/github_key）。
添加SSH密钥到远程平台后仍报错，可能是什么原因？
可能是密钥未添加到本地ssh-agent导致“未激活”。需通过命令将密钥添加到代理：ssh-add ~/.ssh/id_rsa（替换为你的密钥文件名）。若提示“Could not open a connection to your authentication agent”，先启动ssh-agent：eval "$(ssh-agent -s)"，再执行ssh-add。 需确认远程平台添加的公钥内容完整（以ssh-ed25519或ssh-rsa开头，以邮箱 ），避免复制时遗漏字符。
如何确认SSH连接已成功建立？
可通过测试命令直接验证与远程平台的连通性。以GitHub为例，执行：ssh -T git@github.com，若返回“Hi [用户名]! You’ve successfully authenticated…”则表示连接成功。GitLab用户使用ssh -T git@gitlab.com，Gitee用户使用ssh -T git@gitee.com。若提示“Permission denied”，则需重新检查密钥生成、同步及权限配置步骤。
同一台电脑需要连接多个Git平台（如GitHub和GitLab），如何管理多个SSH密钥？
需通过配置~/.ssh/config文件区分不同平台的密钥。在.ssh目录下创建config文件（touch ~/.ssh/config），添加内容：
Host github.com
HostName github.com
User git
IdentityFile ~/.ssh/github_key
Host gitlab.com
HostName gitlab.com
User git
IdentityFile ~/.ssh/gitlab_key
（替换为你的密钥路径）。保存后，克隆仓库时Git会自动匹配对应密钥，避免冲突。
HTTPS协议和SSH协议克隆仓库有什么区别？为什么协议错误会导致“Permission denied”？
HTTPS协议通过用户名密码或令牌（token）认证，而SSH通过密钥认证。若远程仓库地址使用SSH协议（如git@github.com:user/repo.git），但本地未配置SSH密钥，会直接触发“Permission denied (publickey)”；若地址用HTTPS（如https://github.com/user/repo.git）却误操作SSH密钥，可能提示“403 Forbidden”而非publickey错误。克隆前需确认仓库地址协议与本地认证方式匹配：通过git remote -v可查看当前仓库使用的协议。
