如何自动化管理多个GitHub分叉仓库的上游同步流程？

一、GitHub原生工具实现自动同步（带冲突提醒） #

GitHub没有直接的内置自动同步分叉功能，但可以通过以下两种方式实现：

1. 用Dependabot自动同步上游 #

Dependabot不仅能管理依赖，还可配置同步上游分支：

• 在每个分叉仓库的.github/dependabot.yml中添加配置，指定你的repo-1作为上游源，它会定期检查上游变更，自动创建PR合并变更。
• 若出现冲突，PR会直接标记为「需要手动解决冲突」，仓库维护者会收到GitHub的邮件/站内信通知，处理完冲突即可合并PR。
• 配置示例：

  version: 2
  updates:
    - package-ecosystem: "git"
      directory: "/"
      schedule:
        interval: "daily"
      upstream: "你的GitHub用户名/repo-1"
  

  注：需确保Dependabot拥有仓库的写入权限。

2. 用GitHub Actions自定义同步流程 #

编写工作流文件，可定时触发或手动触发同步，冲突时自动创建Issue提醒：

• 工作流会自动拉取上游变更，尝试合并到分叉的main分支，无冲突则直接推送；有冲突则生成Issue提示手动处理。
• 示例工作流文件（.github/workflows/sync-upstream.yml）：

  name: 同步上游变更
  on:
    schedule:
      - cron: "0 0 * * *" # 每天凌晨执行一次
    workflow_dispatch: # 支持手动触发
  jobs:
    sync:
      runs-on: ubuntu-latest
      steps:
        - name: 拉取仓库代码
          uses: actions/checkout@v4
          with:
            fetch-depth: 0
            persist-credentials: false
        - name: 添加上游远程仓库
          run: git remote add upstream https://github.com/你的用户名/repo-1.git
        - name: 获取上游最新代码
          run: git fetch upstream
        - name: 尝试合并上游main分支
          run: |
            git checkout main
            git merge upstream/main --no-edit
          continue-on-error: true
        - name: 无冲突则推送代码
          if: success()
          uses: ad-m/github-push-action@master
          with:
            branch: main
            github_token: ${{ secrets.GITHUB_TOKEN }}
        - name: 冲突时创建提醒Issue
          if: failure()
          uses: actions/github-script@v6
          with:
            script: |
              github.rest.issues.create({
                owner: context.repo.owner,
                repo: context.repo.repo,
                title: '上游同步冲突需手动处理',
                body: '同步repo-1的main分支时出现合并冲突，请及时处理。'
              })
        - name: 推送到Heroku（按需保留）
          if: success()
          run: git push heroku main
  

二、编写Bash脚本批量处理本地分叉仓库 #

如果所有分叉仓库都由你本地维护，可写脚本批量执行同步步骤，冲突时暂停提示手动处理：

脚本示例 #

#!/bin/bash

# 配置上游仓库地址和分叉仓库存放目录
UPSTREAM_REPO="https://github.com/你的用户名/repo-1.git"
REPOS_DIR="/path/to/your/repos"

# 遍历所有仓库
for repo in "$REPOS_DIR"/*; do
  if [ -d "$repo/.git" ]; then
    echo "=== 开始同步仓库: $(basename $repo) ==="
    cd "$repo" || exit 1

    # 若未添加上游远程则添加
    if ! git remote | grep -q upstream; then
      git remote add upstream "$UPSTREAM_REPO"
    fi

    git fetch upstream
    git checkout -b merge-upstream main

    # 尝试拉取上游代码
    if git pull upstream main; then
      # 无冲突则合并推送
      git checkout main
      git rebase merge-upstream
      git push origin main
      git push heroku main
      git branch -D merge-upstream
      echo "✅ $(basename $repo) 同步完成"
    else
      # 冲突时提示手动处理
      echo "❌ $(basename $repo) 出现合并冲突，请手动处理后继续"
      echo "当前目录: $(pwd)"
      read -p "处理完成后按回车继续..."
      # 处理完后完成推送
      git push merge-upstream
      git checkout main
      git rebase merge-upstream
      git push origin main
      git push heroku main
      git branch -D merge-upstream
      echo "✅ $(basename $repo) 手动处理后同步完成"
    fi

    cd "$REPOS_DIR" || exit 1
    echo ""
  fi
done

echo "所有仓库同步操作已完成"

使用说明 #

1. 修改脚本中的UPSTREAM_REPO和REPOS_DIR为你的实际路径
2. 给脚本添加执行权限：chmod +x sync-repos.sh
3. 运行脚本：./sync-repos.sh

三、方案选择建议 #

• 若分叉仓库由客户/朋友独立维护，优先用GitHub Actions + Dependabot，无需本地操作，冲突直接通知维护者处理
• 若所有分叉仓库均由你维护，Bash脚本更高效，可批量完成同步操作

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