如何将GitHub开放Pull Request合并至Fork？含Stream Handbook场景解法

Hey there! Let's tackle your GitHub questions one by one, with practical, actionable steps:

首先明确：这里的开放PR应该是指上游原仓库的未合并PR（毕竟你自己Fork的PR通常是你提交的，合并起来更简单）。下面是两种可靠的实现方式：

方式一：手动Git命令操作 #

适用于单个PR的处理，步骤清晰：

• 先确保你的本地Fork已经关联了上游原仓库：
  1. 查看当前远程仓库：git remote -v，如果没看到upstream条目，就添加：git remote add upstream [原仓库的HTTPS/SSH地址]
  2. 拉取上游仓库的所有最新代码和PR：git fetch upstream
• 拉取目标PR到本地临时分支：
  假设要合并的PR编号是#123，执行：git fetch upstream pull/123/head:pr-123
  切换到这个临时分支：git checkout pr-123
• 合并到你的Fork目标分支（比如main）：
  切回目标分支：git checkout main
  合并临时分支：git merge pr-123
  如果出现冲突，手动解决冲突后提交即可
• 推送合并后的代码到你的Fork远程仓库：git push origin main
• 最后可以删除本地临时分支：git branch -D pr-123

方式二：用GitHub CLI（更快捷） #

如果经常处理PR，推荐用GitHub官方的CLI工具：

1. 先安装gh CLI并完成授权：gh auth login
2. 直接拉取目标PR并合并到你的分支：
   • 拉取PR到本地：gh pr checkout 123 --repo [原仓库的所有者/仓库名]（比如gh pr checkout 123 --repo stream-handbook/stream-handbook）
   • 切回你的目标分支（如main）：git checkout main
   • 合并PR分支：git merge pr/123
   • 推送至你的Fork：git push origin main

能不能合并？ #

当然可以！但有个重要前提：不是所有开放PR都适合合并。有些PR可能是未完成的、存在代码冲突、或者不符合项目规范的，合并前一定要逐个查看PR的内容、讨论和状态，确认是你需要的修改。如果直接批量合并所有PR，很可能会引入大量冲突或bug。

最简实现方式（批量处理） #

如果已经筛选好要合并的PR，用GitHub CLI+简单脚本可以高效批量处理：

1. 先确保本地Fork已关联上游，并且gh CLI已授权
2. 编写一个简单的Shell脚本（比如merge-prs.sh）来批量合并：

#!/bin/bash

# 替换成你的目标分支（比如main）
TARGET_BRANCH="main"
# 替换成上游仓库的所有者/仓库名
UPSTREAM_REPO="stream-handbook/stream-handbook"

# 切到目标分支并拉取最新代码
git checkout $TARGET_BRANCH
git pull upstream $TARGET_BRANCH

# 遍历所有开放PR并合并（这里可以添加筛选条件，比如只合并label为"bugfix"的PR）
for PR_NUMBER in $(gh pr list --repo $UPSTREAM_REPO --state open --json number --jq '.[].number'); do
    echo "=== 开始处理PR #$PR_NUMBER ==="
    # 拉取PR到本地临时分支
    git fetch upstream pull/$PR_NUMBER/head:pr-$PR_NUMBER
    # 合并到目标分支（--no-edit跳过提交信息编辑，有冲突时脚本会中断，需手动解决）
    git merge pr-$PR_NUMBER --no-edit
    # 删除本地临时分支
    git branch -D pr-$PR_NUMBER
done

# 推送合并后的代码到你的Fork
git push origin $TARGET_BRANCH

3. 给脚本添加执行权限：chmod +x merge-prs.sh
4. 运行脚本：./merge-prs.sh

注意事项 #

• 脚本会按PR编号顺序合并，如果遇到冲突会停止运行，你需要手动解决冲突后再重新执行
• 优先合并依赖其他PR的修改，避免合并顺序导致的冲突
• 合并后一定要本地测试代码，确保功能正常再推送

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