如何在GitHub Actions中克隆CocoaPods私有Spec仓库以执行pod install

问题根因 #

你遇到的两个报错分别对应两个独立问题：

1. 第一个报错是因为actions/checkout内置了路径限制，只能将仓库检出到当前CI工作区目录下，不能直接写入工作区外的~/.cocoapods/repos路径
2. 第二个报错是因为你之前配置的git替换规则仅覆盖了https://github.com/开头的HTTPS协议地址，但你的CocoaPods私有源配置用的是git@github.com:开头的SSH协议地址，替换规则没有生效导致身份验证失败。

最优解决方案 #

直接扩展git全局替换规则，同时覆盖SSH和HTTPS两种协议的GitHub地址，无需修改原有Podfile配置，也不需要额外配置SSH密钥：

- name: Configure git authentication for private repos
  env:
    GH_ACCESS_TOKEN: ${{ secrets.GH_ACCESS_TOKEN }}
  run: |
    # 替换HTTPS协议GitHub地址
    git config --global url."https://${GH_ACCESS_TOKEN}@github.com/".insteadOf "https://github.com/"
    # 新增替换SSH协议GitHub地址，适配私有CocoaPods源的SSH配置
    git config --global url."https://${GH_ACCESS_TOKEN}@github.com/".insteadOf "git@github.com:"

配置完成后直接执行pod install即可，CocoaPods拉取私有Spec仓库时会自动将SSH地址替换为带个人访问令牌的HTTPS地址，完成身份验证后正常拉取代码。

备选方案（可选） #

如果需要更稳定的流程，也可以主动提前将私有Spec仓库添加到CocoaPods本地源列表：

- name: Add private CocoaPods spec repo
  env:
    GH_ACCESS_TOKEN: ${{ secrets.GH_ACCESS_TOKEN }}
  run: |
    pod repo add private-cocoapods-spec https://${GH_ACCESS_TOKEN}@github.com/fishcharlie/Private-CocoaPods-Spec.git
    pod repo update private-cocoapods-spec

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