如何自动将Fork仓库的master分支同步至GitHub上游仓库？

首先得明确一个核心前提：如果你没有上游仓库的写入权限，直接自动把你的Fork的master合并到上游master是完全做不到的——上游仓库的维护者不可能允许外部仓库直接推送代码，这是Git协作里安全和权限管理的基本规则。这种情况下，自动创建Pull Request是唯一可行的方案。

如果你确实拥有上游仓库的写入权限，那自动合并的流程是可以实现的，下面分别拆解两种场景的具体实现方式：

场景1：拥有上游写入权限，自动合并到上游master #

用GitHub Actions就能搞定这个自动化流程，步骤很清晰：

1. 到你的Fork仓库里，新建一个.github/workflows/auto-merge-to-upstream.yml文件
2. 写入下面的Workflow配置，它会监听master分支的推送事件，或者PR合并到master的事件，然后自动拉取上游代码、合并、推送到上游：

name: Auto Merge Fork Master to Upstream
on:
  push:
    branches: [ master ]
  pull_request:
    branches: [ master ]
    types: [ closed ]
    if: github.event.pull_request.merged == true

jobs:
  merge-to-upstream:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout Fork Repository
        uses: actions/checkout@v4
        with:
          fetch-depth: 0
          token: ${{ secrets.GITHUB_TOKEN }}

      - name: Add Upstream Remote
        run: |
          git remote add upstream https://github.com/[上游仓库用户名]/[上游仓库名].git
          git fetch upstream

      - name: Merge & Push to Upstream
        run: |
          git checkout master
          # 先拉取上游最新代码，避免冲突
          git pull upstream master --no-edit
          git push upstream master
        env:
          GITHUB_TOKEN: ${{ secrets.PERSONAL_ACCESS_TOKEN }}

几个关键点要注意：

• 这里不能用默认的GITHUB_TOKEN，得用个人访问令牌（Personal Access Token），因为默认令牌没有上游仓库的推送权限
• 生成令牌的时候一定要勾选repo权限
• 如果合并时出现冲突，这个Workflow会直接失败，这时候就得手动解决冲突后再推送了

场景2：无上游写入权限，自动创建Pull Request到上游 #

这是更常见的场景，同样用GitHub Actions实现，步骤如下：

1. 在你的Fork仓库里新建.github/workflows/auto-create-upstream-pr.yml文件
2. 写入下面的配置，当你的master分支有代码合并或推送时，自动向上游仓库创建PR：

name: Auto Create PR to Upstream
on:
  push:
    branches: [ master ]
  pull_request:
    branches: [ master ]
    types: [ closed ]
    if: github.event.pull_request.merged == true

jobs:
  create-upstream-pr:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout Fork Repo
        uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Auto Generate PR to Upstream
        uses: repo-sync/pull-request@v2
        with:
          source_branch: "master"
          destination_branch: "master"
          github_token: ${{ secrets.PERSONAL_ACCESS_TOKEN }}
          pr_title: "Auto-sync: Fork master changes to upstream"
          pr_body: "This PR is automatically created when changes are merged to the Fork's master branch.\n\nFeel free to review and merge if everything looks good!"
          repository: "[上游仓库用户名]/[上游仓库名]"

如果你想要更灵活的逻辑（比如避免重复创建PR），可以用actions/github-script来实现：

name: Auto Create Upstream PR
on:
  push:
    branches: [ master ]

jobs:
  create-pr:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/github-script@v7
        with:
          github-token: ${{ secrets.PERSONAL_ACCESS_TOKEN }}
          script: |
            const { owner, repo } = context.repo;
            // 替换成上游仓库的用户名和仓库名
            const upstreamOwner = '[上游仓库用户名]';
            const upstreamRepo = '[上游仓库名]';

            // 先检查有没有已经存在的相同PR
            const existingPRs = await github.rest.pulls.list({
              owner: upstreamOwner,
              repo: upstreamRepo,
              head: `${owner}:master`,
              base: 'master'
            });

            if (existingPRs.data.length === 0) {
              // 没有的话就创建新PR
              await github.rest.pulls.create({
                owner: upstreamOwner,
                repo: upstreamRepo,
                title: 'Auto-sync: Fork master updates',
                head: `${owner}:master`,
                base: 'master',
                body: 'This PR is automatically generated when changes are pushed to the Fork\'s master branch.\n\nPlease review the changes before merging.'
              });
              console.log('Pull Request created successfully!');
            } else {
              console.log('A Pull Request from this Fork\'s master to upstream already exists, skipping creation.');
            }

注意事项：

• 还是需要个人访问令牌，记得勾选repo权限
• PR的标题和内容可以根据你的需求自定义，比如加上本次合并的提交记录
• 第二个脚本会自动检查是否已有相同的PR，避免重复创建

总结一下 #

• 没有上游写入权限：只能自动创建PR，这是GitHub协作里的标准方式，上游维护者会收到通知并进行审核
• 有上游写入权限：可以实现自动合并，但一定要注意冲突处理——建议在Workflow里加上冲突检测的逻辑，或者设置邮件/消息通知，方便你手动处理冲突

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