GitHub Action更新PR中.gitignore忽略文件报错及原因咨询

原因解析 #

在PR触发的GitHub Action工作流中，actions/checkout@v4的默认行为是检出PR的合并临时分支（如refs/pull/290/merge），而非PR的源分支（即你提交代码的原始分支）。这个合并分支是GitHub临时生成的，用于模拟PR合并到目标分支后的状态，它并不是你要推送变更的源分支的本地副本。

当你尝试直接推送生成的roles/*/README.md文件时，Git找不到对应源分支的本地引用，就会抛出src refspec 290/merge does not match any错误——因为你试图推送的是这个临时合并分支，而远程仓库根本不存在该分支。

你手动执行git fetch并切换到github.event.pull_request.head.ref分支，本质是拉取到了真正的源分支本地副本，这样才能将变更正确推送到远程的源分支上。

优化建议 #

无需手动执行fetch和分支切换，直接修改actions/checkout@v4的配置，让它直接检出PR的源分支：

- name: Checkout PR source branch
  uses: actions/checkout@v4
  with:
    ref: ${{ github.event.pull_request.head.ref }}
    repository: ${{ github.event.pull_request.head.repo.full_name }} # 处理fork仓库的PR时需要配置
    fetch-depth: 0 # 拉取完整历史，避免推送时的历史不匹配问题
    persist-credentials: true # 保留凭证，方便后续推送操作

推送时直接指定目标分支为${{ github.event.pull_request.head.ref }}即可。如果是处理fork仓库的PR，还需确保GitHub Token拥有推送权限。

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