GitHub Actions中PR与master分支Diff报错及轻量查询方案咨询

错误原因 #

GitHub Actions默认的代码拉取是浅克隆，只会拉取当前PR分支的最新提交，本地根本没有master分支的引用，自然找不到master这个对象。

两种高效解决方案（无需完整克隆大型仓库） #

方法一：快速拉取master分支引用 #

不用完整克隆仓库，只拉取master分支的最新提交到本地，就能正常用git diff对比。

在你的GitHub Actions工作流里，checkout之后加一步fetch命令：

jobs:
  diff-job:
    runs-on: ubuntu-latest
    steps:
      - name: 拉取当前分支代码
        uses: actions/checkout@v4
        with:
          fetch-depth: 1 # 保持浅克隆，只拉当前分支最新提交
      - name: 拉取master分支引用
        run: git fetch origin master:master
      - name: 执行你的Node差异脚本
        run: node your-diff-script.js

脚本里的git diff命令可以按需选两种格式：

• git diff --name-only master...HEAD：对比PR分支与master的合并基础（更准确反映PR实际变更）
• git diff --name-only master HEAD：直接对比两个分支的最新提交

方法二：用GitHub API直接拿PR差异（完全不用克隆仓库） #

如果仓库特别大，连拉master都嫌麻烦，直接调用GitHub API获取PR的变更文件列表，效率更高。

Node脚本示例（用官方的actions工具包）：

const core = require('@actions/core');
const github = require('@actions/github');

async function getPRChangedFiles() {
  const token = process.env.GITHUB_TOKEN;
  const octokit = github.getOctokit(token);
  const { context } = github;

  // 只在PR触发时运行
  if (!context.payload.pull_request) {
    core.setFailed('这个脚本只支持PR触发的工作流');
    return;
  }

  const prNumber = context.payload.pull_request.number;
  // 调用API获取PR的所有变更文件
  const { data: files } = await octokit.rest.pulls.listFiles({
    owner: context.repo.owner,
    repo: context.repo.repo,
    pull_number: prNumber,
  });

  // 这里可以按你的需求处理文件列表，比如筛选特定类型文件
  files.forEach(file => {
    console.log(`变更文件：${file.filename}，类型：${file.status}`);
  });
}

getPRChangedFiles().catch(err => core.setFailed(err.message));

对应的工作流配置（不用checkout整个仓库）：

jobs:
  pr-diff-api:
    runs-on: ubuntu-latest
    steps:
      - name: 配置Node环境
        uses: actions/setup-node@v4
        with:
          node-version: 20
      - name: 安装依赖
        run: npm install @actions/core @actions/github
      - name: 执行PR差异脚本
        run: node your-api-script.js
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

两种方法对比 #

• 方法一：改动小，适合已经依赖git diff逻辑的现有脚本，快速解决问题。
• 方法二：完全不用克隆仓库，效率更高，还能直接拿到GitHub提供的文件变更状态（新增/修改/删除），适合超大型仓库。

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