首页/开发/Git 与协作速查/堆叠式 PR(stacked PR)
协作与代码评审75 条

堆叠式 PR(stacked PR)

把大改动拆成一串有先后依赖的 PR,每个都基于前一个分支:评审粒度小、可逐个合入,合并时按顺序从底部向上推进。

Git 与协作速查开发更新于 2026-10-12
结构feature/1 → feature/2 → feature/3 依次为基
合并顺序自底向上;上层需在下层合入后变基
工具git rebase --update-refs(2.38+)可一次同步多条堆叠分支

同步示例

同步示例
git switch feature/1
git rebase origin/main
git rebase --update-refs origin/main   # 同步下游堆叠分支
git branch -vv
平台不会自动处理顺序:底部 PR 合入后,上层 PR 的分支需要重新指向新主干位置,否则 diff 会包含已合入内容。

易错点

  • 顺序合并期间上层 PR 的描述与 diff 会变化,评审人需要重新核对范围
  • 临时调整顺序(先合上层)会造成依赖断裂,动手前确认依赖方向

数据来源与参考

  • GitHub Docs:About stacked pull requests(社区实践,平台文档)
  • Git 官方文档:git-rebase(--update-refs)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌