Permission denied (publickey)错误核心是SSH认证失败，需检查URL协议是否为SSH、密钥是否存在且已加载（ssh-add -l）、私钥权限是否为600、OpenSSH高版本是否需在~/.ssh/config中添加HostkeyAlgorithms +ssh-rsa等兼容配置，并清理钥匙串与Git凭据缓存。
MacOS中Git克隆失败，若报错含 Permission denied (publickey) 或反复提示输入密码却验证不通过，大概率不是网络或仓库地址问题，而是本地SSH身份认证环节出现权限冲突——比如密钥未加载、算法不兼容、路径错配或凭据缓存干扰。核心是让Git能稳定、可信地用你的私钥完成身份校验。
确认是否真在用SSH协议
很多人误以为自己配置了SSH，实际clone命令用的仍是HTTPS地址。先检查当前远程URL：
- 运行
git remote get-url origin（若尚未初始化仓库，直接看你的clone命令） - 如果是
https://...，那根本没走SSH，报错不会是publickey；此时应改用SSH地址，或按HTTPS方式配凭据 - 正确SSH格式示例：
git@github.com:user/repo.git或git@gitlab.com:group/project.git
检查并加载可用的SSH密钥
即使生成过密钥，也不代表它正被ssh-agent使用。常见断点在这里：
Git Worktree
下载
Git Worktree 多需求并行开发助手：在当前 worktree 目录独立开发、修改、提交代码，不跨目录。基于目录命名规范自动识别仓库归属（如 main-repo-feature‑a → main‑repo 仓库）。遵循最小改动原则，从需求分析到 commit 交付全流程负责。触发场景：用户在 ...
- 列出已加载的密钥：
ssh-add -l，若返回The agent has no identities，说明没加载 - 查看密钥是否存在：
ls -al ~/.ssh/id_*.pub，推荐优先使用id_ed25519.pub（更安全、兼容性好） - 加载私钥（macOS需加钥匙串支持）：
eval "$(ssh-agent -s)" && ssh-add --apple-use-keychain ~/.ssh/id_ed25519 - 若用默认rsa密钥，替换为
id_rsa；注意私钥权限必须是600：chmod 600 ~/.ssh/id_rsa
修复OpenSSH高版本算法兼容性问题
macOS自带或Homebrew安装的较新OpenSSH（≥8.8）默认禁用ssh-rsa签名算法，而部分Git服务端（尤其老旧GitLab实例）仍依赖它，导致连接时卡在 no mutual signature algorithm。
- 在
~/.ssh/config中添加以下配置（没有就新建）：
Host * HostkeyAlgorithms +ssh-rsa PublickeyAcceptedKeyTypes +ssh-rsa
- 保存后无需重启终端，直接测试：
ssh -T git@github.com或对应平台域名 - 成功会返回类似
Hi username! You've successfully authenticated...
清理干扰项：凭据缓存与旧密钥残留
系统钥匙串或Git凭据管理器可能存着过期的HTTPS账号/令牌，或错误的SSH密钥记录，造成混用冲突：
- 清空Git凭据缓存：
git config --global --unset credential.helper，再重新设为store或osxkeychain - 打开“钥匙串访问”，搜索
git或github，删掉所有相关互联网密码条目 - 若曾多次生成密钥，删除冗余文件（如
id_rsa_old、id_rsa_2），避免ssh-agent误加载
不复杂但容易忽略，关键在路径、算法、加载状态三者对齐。验证只需一步：ssh -T git@your-git-server.com 返回成功，后续clone基本就不会卡权限了。
