GitHub Actions工作流中检出master分支失败问题排查

核心原因 #

CI/CD环境（比如GitHub Actions）默认采用浅克隆+仅拉取当前PR关联分支的方式，本地不会自动创建master分支。你执行git fetch后，只是把远程仓库的master分支同步到了本地的远程跟踪分支origin/master，但本地不存在master这个本地分支引用，所以git checkout master -- ...会报“无效引用”错误。

你本地环境能成功，是因为本地已经存在master本地分支，Git可以直接识别这个引用。

快速解决办法 #

不用创建本地master分支，直接用远程跟踪分支origin/master拉取目标文件：

git checkout origin/master -- .github/appvps.yaml

备选方案（需本地master分支时用） #

如果后续操作需要用到本地master分支，可以先基于远程分支创建本地分支再执行checkout：

git checkout -b master origin/master
git checkout master -- .github/appvps.yaml

GitHub Actions 优化补充 #

如果是在GitHub Actions中运行，也可以修改actions/checkout配置，让它完整克隆所有分支（但会增加拉取耗时）：

- uses: actions/checkout@v4
  with:
    fetch-depth: 0  # 完整克隆仓库所有历史与分支
    ref: ${{ github.head_ref }}

不过这种方式远不如直接用origin/master高效。

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