怎么解决MacOS中由于权限冲突导致的Git克隆失败问题-Mac OS-PHP中文网

permission denied (publickey)错误核心是ssh认证失败，需检查url协议是否为ssh、密钥是否存在且已加载（ssh-add -l）、私钥权限是否为600、openssh高版本是否需在~/.ssh/config中添加hostkeyalgorithms +ssh-rsa等兼容配置，并清理钥匙串与git凭据缓存。

怎么解决macos中由于权限冲突导致的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使用。常见断点在这里：

Cnb Cool Git

CNB 云原生构建平台的 Git 操作技能，支持代码克隆、提交、推送、分支管理、Merge Request 管理、流水线触发与结果读取。初次使用需收集用户的 Git 用户名和邮箱。

下载

列出已加载的密钥：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基本就不会卡权限了。