如何把多个提交压缩成一个合并到目标分支(Squash Merge)
把多个提交压成一个合入目标分支:切到目标分支执行 git merge --squash <源分支>,再 git commit 写一条总括信息即可。GitHub 的 Squash and merge 按钮同理。源分支后续应删除避免重复冲突。
最简单的方式是 git merge --squash:切到目标分支,执行 git merge --squash feature-x——源分支的全部改动会合并进暂存区但不产生合并提交,你写一条总括的提交信息 git commit 即可。功能分支的几十个 WIP 提交在主分支上只留下一条干净记录。
操作步骤
git checkout main
git merge --squash feature-x # 改动进暂存区,不自动提交
git commit -m "实现支付功能:支持微信/支付宝渠道"
GitHub 等价操作
PR 页面选 Squash and merge:所有提交压缩成一条进主分支,提交信息可编辑。团队可以在仓库 Settings 里强制只许 squash merge,保持主分支历史干净。
squash 后源分支的处理
# 先确认目标提交已包含预期内容,并保留需要的原历史
git branch -D feature-x # 仅在明确决定删除且-d拒绝时使用
git push origin --delete feature-x
squash 合并后源分支的原始提交并不在 main 的祖先链上,继续开发可能使后续比较和合并更复杂,但不是必然冲突;通常从新目标tip建后续分支,原分支是否删除由团队与保留需求决定。
常见问题(FAQ)
Q:merge --squash 和 squash and merge 有区别吗?
结果都可为单提交,但托管平台还涉及权限、分支规则、提交元数据等,不是所有细节等价。命令行版不产生合并提交(历史完全线性);GitHub 的按钮同样产生单提交。
Q:想保留提交明细又想要整洁历史怎么办?
在 feature 分支上先 git rebase -i 整理(squash 掉 fixup 类小提交、保留有意义的节点),再普通 merge——兼顾整洁与细节。
Q:squash 合并后还能找回原始提交吗?
源分支删除前,git reflog 或原分支引用还在就都在。不要把 PR 页面当作原始提交永久保留的承诺,需要长期保留时应建立分支或标签引用。