如何配置Github Action实现新建pull request时自动合并

你描述的「PR创建后立刻无校验自动将对应分支合并入main分支」的工作流无法直接无限制实现，核心限制来自GitHub本身的分支保护机制、流程设计逻辑：

• PR的本质是向目标分支发起合并申请，若跳过所有审核、校验环节直接合并，会完全击穿主干分支的质量防护，GitHub默认对这类无校验的直接合并操作做了权限拦截
• 若仓库给main分支配置了分支保护规则（要求CI通过、代码审核、冲突解决等），未满足规则的PR无法被任何账号（包括自动化token）直接合并
• 无前置校验的自动合并逻辑会带来极高的故障风险，未测试、带bug甚至恶意的代码会被直接合入主干

方案1：使用GitHub原生自动合并（最推荐） #

不需要自行编写复杂Actions，直接在仓库设置中开启「自动合并」功能，配合main分支的保护规则即可实现符合工程规范的自动合并：

• 开启路径：仓库Settings -> General -> Pull Requests -> 勾选「Allow auto-merge」
• 配置分支保护规则，要求PR必须满足所有预设条件（CI流水线通过、至少1位审核人批准、无代码冲突、所有讨论已解决）
• 开发者提PR后可以手动点击启用自动合并，等所有准入条件全部满足后，GitHub会自动将PR合并入main，全程不需要人工跟进
• 如果你希望所有符合条件的PR默认开启自动合并，也可以搭配简单的Action在PR创建时自动调用接口开启自动合并状态，不需要开发者手动点

方案2：限定范围的自定义自动合并Action #

如果你确实需要对特定场景的PR实现无人为干预的自动合并，可以编写自定义工作流，但必须加严格的准入判断，禁止全量PR无差别合并，示例工作流配置如下：

name: 限定范围自动合入main
on:
  pull_request:
    types: [opened, synchronize, reopened]

jobs:
  qualified-auto-merge:
    runs-on: ubuntu-latest
    # 仅对满足条件的PR执行：比如分支名以auto/开头、提交者在可信开发者列表
    if: |
      startsWith(github.head_ref, 'auto/') &&
      contains(fromJSON('["dev-zhang", "dev-li", "bot-account"]'), github.actor)
    permissions:
      pull-requests: write
      contents: write
    steps:
      - name: 等待所有必要校验通过
        uses: actions/github-script@v7
        with:
          script: |
            const prNum = context.issue.number
            let allChecksPass = false
            // 轮询检查所有CI规则的运行状态
            while (!allChecksPass) {
              const res = await github.rest.checks.listForRef({
                owner: context.repo.owner,
                repo: context.repo.repo,
                ref: context.payload.pull_request.head.sha
              })
              allChecksPass = res.data.check_runs.every(item => item.conclusion === 'success')
              if (!allChecksPass) await new Promise(resolve => setTimeout(resolve, 15000))
            }
      - name: 执行合并
        run: gh pr merge ${{ github.event.pull_request.number }} --squash --delete-branch
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

方案3：PR分支自动同步main代码（最常用的需求变体） #

很多人提类似需求时实际要的是「PR创建后保持分支和main同步，避免后续合并冲突」，而非直接把PR合入main，这个场景可以直接用成熟的同步Action实现：

• 在PR创建、main分支有新提交时，自动将main的最新代码merge或者rebase到当前PR分支
• 等PR走完审核、校验流程后，再按正常流程合并入main，既减少人工同步的工作量，也不会跳过质量防护

• 永远不要配置无任何准入校验的「PR创建即合并」逻辑，风险不可控
• 所有自动合并逻辑必须配合main分支的保护规则使用，禁止绕过分支保护给token开特殊权限
• 自定义Action使用的GITHUB_TOKEN需要提前在仓库设置中开启读写权限，否则会因权限不足合并失败

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