Git 分支整理实战:rebase -i、cherry-pick 与 squash 的正确用法
Git 分支整理实战:rebase -i、cherry-pick 与 squash 的正确用法
团队协作里最容易失控的不是代码冲突,而是提交历史。一个功能分支提交了 40 次,其中 15 次是「fix typo」、8 次是「再试一次」,合并进主干后 git log 变成一团噪声,出问题想回滚都找不到边界。这篇文章把整理历史的三个主力工具(交互式 rebase、cherry-pick、squash merge)讲清楚,并给出可直接照抄的操作顺序。
一、先明确一个前提:只整理自己的提交
改写历史会改变 commit 的 SHA。规则很简单:
- 未推送的本地提交:随便改。
- 已推送但只有你在用的分支:改完
git push --force-with-lease。 - 多人协作的公共分支(main / develop):永远不改写,只用
git revert追加反向提交。
--force-with-lease 比 --force 安全:它会在推送前检查远端分支是否还是你上次看到的样子,别人推了新提交就拒绝覆盖。
二、交互式 rebase:把 40 个提交压成 3 个
假设分支 feature/order 从 main 拉出来后提交了一堆碎提交:
git switch feature/order
git log --oneline main..HEAD
# a1b2c3d fix typo
# 9f8e7d6 再试一次
# 5c4b3a2 加订单校验
# 1d2c3b4 初始化订单模块
想整理最近 4 个提交:
git rebase -i HEAD~4
编辑器里会列出:
pick 1d2c3b4 初始化订单模块
pick 5c4b3a2 加订单校验
pick 9f8e7d6 再试一次
pick a1b2c3d fix typo
要做的改动:
- 把后三行的
pick改成squash(或简写s),表示合并进上一个提交。 - 如果某个提交完全没价值,改成
drop(d)直接丢弃。 - 如果想改提交信息,改成
reword(r)。
保存退出后,Git 会让你编辑合并后的提交信息。这一步是唯一需要认真写的地方:把「再试一次」这种流水账改成「新增订单金额校验与幂等键」,否则压缩完的提交依然不可读。
最终历史变成:
7a8b9c0 新增订单金额校验与幂等键
1d2c3b4 初始化订单模块
顺序陷阱
rebase -i 列表是从旧到新排列的,和 git log 的倒序相反。第一次用的人经常把 squash 写错位置,结果把最早的初始化提交合进了最新提交里,历史彻底乱掉。
补救只有一条路:git reflog 找到 rebase 之前的 SHA,git reset --hard <SHA> 重来。所以动手前先记一下 git rev-parse HEAD。
三、squash merge:合并时一次性压平
如果团队不想在本地折腾 rebase,可以在合并 PR 时压平:
git switch main
git merge --squash feature/order
git commit -m "feat(order): 订单模块与金额校验"
--squash 会把分支上所有改动放进暂存区,但不产生合并提交、也不保留分支的提交历史。适合「分支内部历史没价值,只要最终结果」的场景。
对比一下三种合并方式:
| 方式 | 历史形态 | 适用场景 |
|---|---|---|
merge --no-ff |
保留分支与合并点 | 长周期功能,需要看清边界 |
merge --squash |
单条提交,无分支痕迹 | 小功能、碎提交多 |
rebase + merge --ff-only |
线性历史,无合并点 | 追求干净线性主干 |
四、cherry-pick:把某个提交搬到另一条线
典型场景:在 develop 上修了一个线上 bug,需要同步到 release/1.2:
git switch release/1.2
git cherry-pick 3e4f5a6
如果要搬一串连续提交:
git cherry-pick 3e4f5a6^..8b7c9d0
注意 ^.. 的语义:从 3e4f5a6 的父提交开始到 8b7c9d0,包含两端,等价于搬这中间的连续区间。
冲突处理
cherry-pick 遇到冲突会停下来:
# 手工解决冲突后
git add <冲突文件>
git cherry-pick --continue
# 或者放弃这次搬运
git cherry-pick --abort
关键认知:cherry-pick 复制的是「改动内容」,不是「提交对象」。所以同一份改动在原分支和新分支会有两个不同的 SHA,将来两边合并时 Git 可能认为这是两处独立改动而重复应用——这就是所谓的「cherry-pick 双胞胎」问题。判断依据是 git patch-id,它按补丁内容算指纹:
git show 3e4f5a6 | git patch-id
git show 9a8b7c6 | git patch-id # 另一个分支上的同一改动
# 两个 hash 相同 = 内容一致
五、常见误操作与修复
误 1:rebase 到一半发现方向错了
git rebase --abort # 完全回到 rebase 之前
误 2:把公共分支 rebase 后强推,同事的分支全乱
这是最贵的错误。除了事前约定,可以在服务端开分支保护,禁止对 main 强推:
# 本地也能自保:把 main 设成不可强推的别名
git config alias.pushmain '!git push origin main'
误 3:squash 之后发现漏了一个文件
不要重新 rebase,直接补一个提交再压:
git add 漏掉的文件
git commit --amend --no-edit # 只适合还没推送的情况
如果已经推送,老老实实追加新提交,别改写公共历史。
六、一套可以直接照抄的日常流程
# 1. 开工前同步主干
git switch main && git pull --ff-only
git switch -c feature/xxx
# 2. 开发中随时提交,不用讲究
git commit -am "wip"
# 3. 提 PR 前整理
git fetch origin
git rebase -i origin/main # 压缩、改信息、丢弃废提交
# 4. 本地验证
git diff origin/main --stat # 确认改动范围符合预期
# 5. 推送(首次用 -u,之后用 lease 强推)
git push -u origin feature/xxx
git push --force-with-lease
第 4 步的 --stat 常被跳过,但它是最后一道保险:整理历史时如果误删了提交,这里会立刻暴露改动文件数异常。
七、判断标准
整理历史不是为了好看,而是为了让「回滚」和「定位」变便宜。三个可量化的自检:
git log --oneline main..HEAD每条提交都能用一句话说清做了什么。- 任意一条提交单独 checkout 出来,项目能编译、能跑测试(保证提交粒度自洽)。
- 提交信息里不出现「fix」「再试」「调整」这类无信息量的词。
做到这三点,出线上问题时 git bisect 才能真正派上用场——它依赖的正是「每条提交都可独立构建」这个前提。
- 点赞
- 收藏
- 关注作者
评论(0)