如何在GitHub Actions脚本中检查分支是否与main分支保持同步？

直接在GitHub Actions里加一个前置检查Job，用Git命令判断main分支是不是当前分支的祖先，一旦发现不同步立刻失败，完全不用等测试环境搭建。

核心实现思路 #

用Git的git merge-base --is-ancestor命令：如果origin/main是当前分支的祖先（也就是当前分支包含main的所有最新提交），命令返回0；反之返回非0，GitHub Actions会自动把非0返回码判定为Job失败。

完整Workflow示例 #

name: CI
on: [pull_request, push]

jobs:
  # 第一步：先做分支同步检查
  check-branch-sync:
    runs-on: ubuntu-latest
    steps:
      - name: 拉取完整代码历史
        uses: actions/checkout@v4
        with:
          fetch-depth: 0  # 必须拉取完整Git历史，不然没法判断分支祖先关系

      - name: 检查当前分支是否与main同步
        run: |
          # 确保本地拿到最新的main分支
          git fetch origin main:origin/main
          # 判断main是否是当前分支的祖先
          if ! git merge-base --is-ancestor origin/main HEAD; then
            echo "❌ 当前分支未同步main分支的最新代码，请先合并main后再提交！"
            exit 1
          fi

  # 第二步：只有检查通过才运行测试（用needs依赖检查Job）
  run-tests:
    needs: check-branch-sync
    runs-on: ubuntu-latest
    steps:
      - name: 拉取代码
        uses: actions/checkout@v4
      # 这里放你的测试环境搭建、运行测试的步骤
      - name: 安装依赖
        run: npm install
      - name: 运行测试
        run: npm test

关键细节说明 #

• fetch-depth: 0：默认GitHub Actions拉代码只会取最近一次提交，必须加这个参数拉完整历史，否则Git没法比较分支的祖先关系。
• git fetch origin main:origin/main：强制拉取最新的main分支到本地，避免因为缓存导致判断出错。
• 用needs让测试Job依赖检查Job：只要检查失败，测试Job会直接跳过，完全不会启动环境搭建，节省5-10分钟的等待时间。

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