首页/开发/Git 与协作速查/把大型 PR 拆成可评审单元
协作与代码评审75 条

把大型 PR 拆成可评审单元

先梳理改动树,再按「可独立合入且可回滚」的边界切分;常见切法:按提交重排拆分、先落接口与开关、机械改动单独一 PR。

Git 与协作速查开发更新于 2026-10-12
拆分依据每个 PR 只做一件事,且单独合并后系统保持可用
常用手法rebase -i 重排并摘出提交到新分支;格式/重命名等机械改动独立提交
标记在描述中说明与其他 PR 的依赖关系

从现有分支摘出提交

从现有分支摘出提交
git switch -c refactor/extract-utils origin/main
git cherry-pick <机械改动提交>
git push -u origin refactor/extract-utils
拆出的每个 PR 都要能跑通 CI;无法独立通过的部分,说明边界还需要调整。

易错点

  • 机械改动与逻辑改动混在一个 PR 会掩盖真实差异,务必分开
  • 为通过 CI 而临时提交的兼容代码要标记 TODO 并在后续 PR 清理

数据来源与参考

  • Google Engineering Practices:Small CLs
  • Git 官方文档:git-cherry-pick
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌