xcodebuild克隆源码时偶发ssh permission denied权限报错

该偶发权限报错是macOS下SSH凭证加载逻辑、Xcode执行上下文、本地多凭证冲突共同导致的：

• 手动执行ssh -T {git address}验证通过，仅代表当前终端会话的SSH上下文已加载有效密钥。xcodebuild拉取Swift包依赖时，不会继承当前终端临时加载的SSH密钥，而是读取系统全局SSH代理的凭证：全局代理加载了有效密钥时操作成功，未加载时直接触发鉴权失败，因此故障无稳定复现规律。
• 删除钥匙串凭证后临时恢复，是因为操作清除了钥匙串中存储的失效凭证（比如输错后缓存的密码、其他仓库的过期密钥、失效的访问凭证），SSH会重新执行密钥匹配流程；后续系统再次自动缓存错误凭证后，故障会复现。
• 多仓库、多分支的测试操作会提升故障概率：如果本地存储了多组对应不同仓库/账号的SSH密钥，SSH默认会按顺序尝试匹配密钥，匹配到无当前仓库权限的密钥时会直接返回权限拒绝，不会继续尝试后续有效密钥。

按以下步骤操作即可彻底修复：

1. 配置SSH强制匹配规则，避免密钥错配
   编辑~/.ssh/config文件，添加对应Git服务的配置项，将{git address}替换为你实际使用的Git服务域名，IdentityFile替换为本地对应有效私钥的路径：

Host {git address}
  UseKeychain yes
  AddKeysToAgent yes
  IdentityFile ~/.ssh/你的私钥文件名（如id_ed25519）
  IdentitiesOnly yes

配置项IdentitiesOnly yes为核心参数，会强制SSH仅使用你指定的私钥做鉴权，不会尝试钥匙串或代理中存储的其他无关凭证。

2. 清理所有失效的旧凭证
   打开「钥匙串访问」，搜索你使用的Git服务域名，删除所有关联的Git/SSH类互联网密码条目，不要残留旧的失效凭证。

3. 将有效密钥永久加载到全局SSH代理
   终端执行以下命令，替换为你自己的私钥路径：

ssh-add --apple-use-keychain ~/.ssh/你的私钥文件名

执行完成后可通过ssh-add -l命令确认对应密钥已出现在返回列表中。

4. 清理Xcode与SwiftPM的历史缓存
   终端依次执行以下命令，清除旧的失败拉取缓存：

rm -rf .swiftpmCache
rm -rf ~/Library/Caches/org.swift.swiftpm
rm -rf ~/Library/Developer/Xcode/DerivedData

完成后重新执行xcodebuild克隆命令即可正常运行，不会再出现偶发权限报错。

内容的提问来源于stack exchange，提问作者Joey