使用GitHub Action实现test与main分支自动同步的问题排查

问题根源 #

你的GitHub Action执行失败，核心原因是actions/checkout@v3的默认行为导致的：

• 默认只做浅克隆（depth: 1），仅拉取触发工作流的main分支最新提交，不会拉取完整仓库历史
• 同时默认只拉取当前触发分支，test分支在Action环境中没有完整的历史记录，Git误判为“无关历史”
• 手动操作时本地有完整仓库历史，所以不会出现这类问题

修复后的Action配置 #

直接修改checkout步骤拉取完整历史，并且简化同步逻辑（因为test分支无手动提交，直接快进合并更稳妥，避免合并冲突）：

name: Update Test Branch

on:
  push:
    branches: [main]

jobs:
  sync:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout 完整仓库
        uses: actions/checkout@v3
        with:
          fetch-depth: 0  # 拉取完整仓库历史，解决无关历史问题
          ref: test       # 直接checkout到test分支，省去后续切换步骤

      - name: Setup Git User
        run: |
          git config user.name "GitHub Action"
          git config user.email "<EMAIL>"

      - name: 同步main分支到test
        run: |
          git pull origin main --ff-only  # 快进合并，确保无冲突
          git push origin test

可选更高效的同步方式 #

如果test分支完全不需要保留任何独立提交，直接硬重置为main的最新状态更高效：

# 替换同步步骤的run命令
- name: 同步main分支到test
  run: |
    git reset --hard origin/main
    git push origin test --force-with-lease  # 安全强制推送，避免覆盖未预期提交

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