如何在Swift中使用LibGit2通过SSH克隆公共Git仓库？

我在iOS平台通过Swift调用libgit2实现过完整的SSH克隆功能，你遇到的问题通常是几个常见配置错误导致的，可按以下顺序排查：

1. 确认libgit2已编译SSH支持 #

绝大多数预编译的libgit2 iOS框架默认未集成SSH依赖，你需要自行编译libgit2时开启SSH选项：

• 编译参数加入-DUSE_SSH=ON，同时链接libssh2依赖库
• 你可以在回调中打印git_cred_ssh_key_memory_new的返回值，若返回非GIT_OK且错误码为GIT_ENOTFOUND，基本可判定是未编译SSH支持

2. 确认密钥为PEM格式 #

libgit2依赖的libssh2不支持新版OpenSSH格式的私钥，仅支持PEM格式：

• 正确的PEM格式私钥头部为-----BEGIN RSA PRIVATE KEY-----
• 若你的密钥是OpenSSH格式（头部为-----BEGIN OPENSSH PRIVATE KEY-----），可执行以下命令重新生成PEM格式密钥：
  ssh-keygen -m PEM -t rsa -b 4096

3. 修复密钥数据的null终止符问题 #

libgit2要求传入的公钥、私钥数据为标准C字符串，末尾必须带\0终止符，直接用Swift Data转换会缺失终止符导致内存读错误，正确的转换方式：

// 示例：将密钥字符串转为带null终止符的Data
let pubkeyData = publicKeyStr.data(using: .utf8)! + Data([0])
let privateKeyData = privateKeyStr.data(using: .utf8)! + Data([0])

若你的密钥无加密，passphrase参数需传nil，不可传空字符串。

4. 修正回调中的SSH用户名取值 #

你当前代码中sshMemory分支用的是自定义传入的用户名，而Bitbucket等平台的SSH地址要求用户名固定为git，建议直接使用回调参数中从URL解析出的用户名，修改对应分支代码：

case .sshMemory(_, let publicKey, let privateKey, let passphrase):
    guard let sshUsername = name else { return -1 }
    result = git_cred_ssh_key_memory_new(cred, sshUsername, publicKey, privateKey, passphrase)

5. 开启libgit2日志定位具体错误 #

可开启libgit2的trace日志输出，精准定位错误环节：

git_libgit2_init()
git_trace_set(GIT_TRACE_INFO, { _, msg in
    guard let msg = msg else { return }
    print("libgit2错误日志：\(String(cString: msg))")
})

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