如何无需CLI实现PR快进式变基合并？GitHub Action方案探讨

可行性说明 #

这个方案是可行的，但没法直接监听GitHub原生的“Rebase and Merge”按钮点击（GitHub未开放这个层级的事件钩子）。我们可以通过替代触发方式+Action逻辑来实现，既能做到类似“一键操作”的体验，又能避免原生选项改写提交时间和作者的问题。

具体实现步骤 #

1. 禁用仓库原生合并选项 #

先去仓库设置的「Branches」页面，找到目标基准分支的保护规则，关掉所有UI合并选项（包括Rebase and Merge、Squash Merge、创建合并提交），防止用户误点原生按钮。

2. 编写GitHub Action工作流 #

在仓库里创建.github/workflows/fast-forward-rebase.yml文件，实现快进式合并的逻辑：

name: 快进式变基合并

on:
  # 方式1：手动触发（在Actions页面选这个工作流，输入PR编号运行）
  workflow_dispatch:
    inputs:
      pr_number:
        description: 'PR编号'
        required: true
        type: number
  # 方式2：给PR加指定标签触发（比如加「fast-forward-merge」标签）
  pull_request:
    types: [labeled]

jobs:
  fast-forward-merge:
    runs-on: ubuntu-latest
    # 只有手动触发或标签匹配时才运行
    if: (github.event_name == 'workflow_dispatch') || (github.event.label.name == 'fast-forward-merge')
    steps:
      - name: 拉取仓库代码
        uses: actions/checkout@v4
        with:
          fetch-depth: 0 # 拉取完整提交历史

      - name: 获取PR信息
        id: pr-info
        run: |
          # 手动触发用输入的PR编号，标签触发用事件里的PR编号
          PR_NUMBER=${{ github.event.inputs.pr_number || github.event.pull_request.number }}
          # 获取PR的源分支和基准分支
          HEAD_REF=$(gh pr view $PR_NUMBER --json headRefName --jq '.headRefName')
          BASE_REF=$(gh pr view $PR_NUMBER --json baseRefName --jq '.baseRefName')
          echo "head_ref=$HEAD_REF" >> $GITHUB_OUTPUT
          echo "base_ref=$BASE_REF" >> $GITHUB_OUTPUT
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

      - name: 执行快进式合并
        run: |
          # 切换到基准分支
          git checkout ${{ steps.pr-info.outputs.base_ref }}
          # 拉取最新代码
          git pull origin ${{ steps.pr-info.outputs.base_ref }}
          # 执行快进式合并（只有源分支是基准分支直接上游时才生效）
          git merge --ff-only ${{ steps.pr-info.outputs.head_ref }}
          # 推送到远程仓库
          git push origin ${{ steps.pr-info.outputs.base_ref }}
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

      - name: 关闭PR
        run: |
          PR_NUMBER=${{ github.event.inputs.pr_number || github.event.pull_request.number }}
          gh pr close $PR_NUMBER --comment "已完成快进式变基合并"
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

3. 优化操作体验 #

• 如果选标签触发：给PR建一个叫「fast-forward-merge」的标签，用户在PR页面点一下添加这个标签，就能自动触发合并，操作和原生按钮差不多。
• 如果选手动触发：在仓库的Actions页面找到这个工作流，点「Run workflow」，输入PR编号就能触发，适合需要额外确认的场景。

4. 处理边界情况 #

• 快进式合并只有在源分支是基准分支的直接上游时才能成功（也就是源分支没冲突，所有提交都在基准分支之后），如果没法快进，Action会失败，这时候得用户手动处理冲突后再触发。
• 确保GITHUB_TOKEN权限足够：在仓库设置的「Actions」→「General」里，把「Workflow permissions」设为「Read and write permissions」，保证Action能推送代码和关闭PR。

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