在GitHub Actions中获取PR的目标分支引用（含非fork来源PR）

我之前在配置PR处理Action的时候也踩过一模一样的坑，刚好能给你分享下靠谱的解决方案：

一、获取所有PR的目标分支（无论是否来自fork） #

你说得没错，${{ github.base_ref }}确实只在来自fork的PR中有效，仓库内发起的PR里这个变量会是空的。要统一覆盖所有PR场景，直接用PR事件 payload 里的内置字段就可以了：

• 使用 ${{ github.event.pull_request.base.ref }}
  这个字段在所有PR事件（包括仓库内的PR和fork来的PR）中都能正确返回目标分支名称，因为它直接取自GitHub发送的PR事件对象，完全不受PR来源的影响。

二、PR事件中获取变更文件列表的正确方法 #

你用于push事件的git diff-tree命令在PR事件里失效，核心原因是PR事件中github.event.before并不是目标分支的最新提交SHA，对比逻辑根本不成立。这里有两种可靠的解决方案：

方案1：用GitHub CLI快速获取（推荐） #

如果你的Action环境里安装了GitHub CLI（gh），可以直接用一行命令拉取PR的变更文件列表：

gh pr view ${{ github.event.pull_request.number }} --json files --jq '.files[].path'

现在大部分官方Action环境已经预装了gh，如果你的环境没有，可以通过简单的安装脚本快速添加，而且这种方式不需要处理Git克隆的细节，省心很多。

方案2：用Git命令对比分支差异 #

如果更倾向于用原生Git命令，首先要确保你的Action完整克隆了仓库（在actions/checkout步骤中设置fetch-depth: 0，避免浅克隆导致无法获取目标分支的完整历史），然后执行以下命令：

# 拉取目标分支的最新代码
git fetch origin ${{ github.event.pull_request.base.ref }}
# 对比当前PR分支与目标分支的合并差异，只输出变更文件名
git diff --name-only origin/${{ github.event.pull_request.base.ref }}...${{ github.sha }}

这里用三个点（...）的diff是关键，它会获取两个分支之间的合并差异，也就是PR实际要合并的内容，比两个点（..）的线性差异更贴合PR的实际变更场景。

额外小提示 #

• 用Git方案时，fetch-depth: 0是必须的，否则可能会因为仓库历史不全导致fetch目标分支失败。
• 如果是私有仓库使用GitHub CLI，要确保Action的GITHUB_TOKEN有足够的权限（默认的GITHUB_TOKEN就可以满足大部分需求）。

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