第二章介绍了如何用 git merge 把两条分支整合到一起。但 merge 有一个固定前提:它会把目标分支自当初分叉以来的全部提交一并合入当前分支。然而在实际开发中,常常出现只需要“局部取用”的场景:例如同事在 feat-profile 分支上连续做了三次提交——第一次 F1 新建了头像模块,第二次 F2 顺手修复了一个公共的邮箱格式校验缺陷,第三次 F3 则是刚写了一半的页面草稿;此时 main 主干急着要发布那个邮箱校验修复 F2,却绝对不能把未完成的 F1 和 F3 一起合并进来。
针对这种“不合并整条分支,只把其中某一个或某几个提交单独复制到当前分支”的需求,Git 提供了 git cherry-pick 命令。本章自顶向下依次理清四个问题:日常使用 cherry-pick 的直接效果是什么、既然每个提交都存着全量快照 Git 凭什么只取出了单次改动、如何批量拣选区间以及处理冲突与陷阱,以及同样基于重放机制实现的 git rebase(变基)与 merge、cherry-pick 该如何划分工程边界。
假设当前仓库在 main 上已经推进到了 M2,而另一条分支 feat-profile 从共同起点 M1 分叉后依次产生了 F1、F2、F3。按照最直观的操作流程,把 F2 单独应用到 main 只需三步:
git log --oneline feat-profile,找到那条 fix(validator): trim whitespace before email check 对应的 Commit 短哈希(即 F2)。在动手前建议顺便执行 git show --stat <F2的哈希>(加上 --stat 表示仅列出本次改动的文件名与增删行数摘要,不展开完整代码),确认这一次提交只改动了相关文件,没有依赖前面的提交。git switch main,然后运行 git cherry-pick -x <F2的哈希>。feat-profile 分支没有任何变动,F1 与未完成的 F3 也没有出现在 main 中;只有 main 分支的末尾多出了一个新的提交 F2',完整带来了 F2 修复邮箱校验的那部分代码改动。在实际团队协作中,推荐养成始终附加 -x 参数的习惯。该参数不会改变代码改动本身,但会自动在新提交说明的末尾追加一行标准记录 (cherry picked from commit <40位完整哈希>),方便日后追溯这笔修改最初是在哪条分支上完成的。
执行完这一步如果仔细查看 git log --oneline,会立刻注意到一个非常关键的现象:main 上新生成的提交 F2' 与原来 feat-profile 上的 F2 改动内容完全一致,但它们的 Commit 哈希却截然不同。要看懂为什么哈希变了,以及 Git 为什么没有把 F1 的文件一并复制过来,就需要拆开它背后的快照计算过程。
第一章曾建立过一个核心结论:Git 每次提交存入对象库的,都是那一时刻整个项目的完整快照,而不是增量补丁。F2 的快照里同时包含 F1 更早引入的修改。那么执行 git cherry-pick F2 时,Git 如何做到只提取 F2 这一步的改动,既不把 F1 的内容带过来,又不覆盖 main 分支在 M2 期间的修改?
答案是 Git 在后台以 F1 为共同参照基准(Base),对 F1、F2、M2 三份快照执行了一次隐式的三路合并(Three-Way Merge)。Git 不能直接拿 M2 与 F2 做两路对比,因为两份快照之间同时混杂了 F1 的改动、M2 的改动与 F2 的改动,直接对比无法区分哪些差异是由 F2 单独引入的。引入基准 F1 后,合并过程分为三步:
F1 与 F2,提取单步净改动:把 F2 的父版本 F1 设为 Base,逐行对比 F1 和 F2。凡是在 F1 与 F2 之间没有变化的内容(包括 F1 更早引入的修改)全部排除,只锁定唯独在 F2 这一步发生变更的文件与行区间(即 F1 -> F2 的净增量)。F1 与 M2,检查目标位置是否冲突:对于 F1 -> F2 未触及的所有文件与代码行,一律维持 M2 的现有内容不变;对于 F1 -> F2 发生变更的行区间,Git 对比 F1 与 M2 检查 M2 在同一位置是否仍与 F1 保持一致——若一致,则安全套用 F2 的修改;若 M2 在该位置也改成了不同内容,则暂停并标记合并冲突。F2':将融合后的完整快照写入对象库,生成接在 M2 之后的新提交 F2'。
图 1:上半部分展示 git cherry-pick -x F2 在分支历史上的效果;下半部分展示 Git 如何以 F2 的上一版本 F1 作为对比起点,算出单步净增量并叠加至 M2 生成 F2'。
现在就能直接看懂为什么 F2' 必然拥有一个全新的 Commit 哈希。第一章介绍过,Commit 对象的哈希是对“项目快照内容、父版本编号、提交时间以及提交说明”一起计算得出的。原来的 F2 的父版本(Parent)指向 F1,而重放生成的 F2' 的父版本变为了 M2,并且提交时间也更新为执行 cherry-pick 的当前时刻(原作者姓名与最初写代码的时间仍会保留);只要父版本或时间戳不同,算出的 Commit 哈希必然是一个全新的数值。
当单次操作不止挑取一个提交,或者目标提交位于复杂历史结构中时,以下几个高频用法与常见限制值得专门掌握。在写相对位置时先补充两个简写符号:对于任意提交 A,在后面加一个符号 ^(即 A^)代表它的上一版本(父提交),而 ~n 代表顺着父版本链往回倒数 n 步(例如 F3~1 就是 F2,F3~2 就是 F1)。
A..B 区间常见遗漏如果需要从另一条分支挑取两三个不连续的提交,只需在命令后面用空格依次列出它们的哈希即可:git cherry-pick <hash1> <hash2>,Git 会严格按照从左到右的顺序逐个重放并生成对应的新提交。
如果要一次挑取从 F1 到 F3 这一整段连续提交,很多人会直觉写出 git cherry-pick F1..F3,结果跑完后发现最前面的 F1 竟然漏掉了,只摘来了 F2 和 F3。这是因为在 Git 的区间定义里,A..B 表示的是“能从 B 追溯到、同时排除能从 A 追溯到的提交”——它是一个左开右闭区间,天然不包含起点 A 本身。要把起点 F1 也包含进来,必须把排除边界再往前回退一格到 F1 的父提交,写成闭区间 "F1^..F3"(在 macOS 默认的 zsh 终端里建议用双引号包住,避免 ^ 字符被 Shell 当作特殊通配符处理;唯一前提是 F1 不能是仓库创建时的最初始第一条提交,因为初始提交没有父节点)。
-n / --no-commit)默认情况下,每拣选一个提交都会在当前分支立刻生成一条新的 commit 记录。如果来源分支上的某两三次提交切得太零碎(例如先写了函数、接着修了一个拼写错误、最后补了注释),你只想把这几次的改动拿过来捏合成一次整洁的提交,可以在命令中加上 -n 参数(完整写法为 --no-commit):
git cherry-pick -n "F1^..F2"
git commit -m "feat: integrate profile helper and email validation fix"
加上 -n 后,Git 依然用三路合并算出改动并写入你的工作区和暂存区,但在最后一步停下来不自动提交,让你自己检查代码并一次性执行 git commit 存档。
和 merge 一样,如果源分支在 F1 -> F2 修改了某个文件的第 10 行,而你当前分支 M2 也改过同一文件的第 10 行且内容不一致,Git 会在执行到这一步时暂停下来并在文件里写入 <<<<<<<、=======、>>>>>>> 冲突标记。此时只有三条清晰的操作路径:
git add <冲突文件名> 告知 Git 冲突已消除,最后执行 git cherry-pick --continue(加上 --no-edit 可直接沿用原提交说明,不需要额外敲 git commit)。git cherry-pick --abort,整个工作区与暂存区会立即还原到执行命令前的干净状态,哪怕队列里有多个提交已摘了一半也能完整退回。git cherry-pick --skip 跳过这一个提交即可。git cherry-pick <ID> 会报错提示缺少 -m 参数。因为普通提交只有 1 个父版本,对比起点唯一;而合并提交有 2 个父版本(第 1 个父版本是当时合并入的主干,第 2 个父版本是被并入的分支),Git 不知道该拿哪个作为 Base 来算改动。若确实需要一次性拿来那次合并引入的全部净变化,需加上 -m 1(git cherry-pick -m 1 <ID>,表示以第 1 父版本主干为基准);但通常更稳妥的做法是避开合并提交,直接去原分支上找具体的普通单父提交。F1 在 utils.py 里新增了一个辅助函数,F2 在 validator.py 里调用了它;如果在 main 上只拣选 F2 而漏了 F1,由于改的不是同一个文件,Git 会毫无冲突地直接成功,但代码运行起来立即报错找不到该函数。因此每次拣选前先用 git show <hash> 看清代码上下依赖是必不可少的习惯。搞透了 cherry-pick 的单点重放机制后,另一个常让人望而生畏的命令 git rebase(变基)其实只需要一句话就能完全拆穿:执行 git rebase main,底层本质上就是让 Git 自动找出你当前分支独有的那一串提交,按顺序批量对它们执行 cherry-pick 接到 main 最新节点的后面,然后把当前分支的指针挪过去。
图 2:在相同的起始分叉结构下分别执行 merge、rebase 与 cherry-pick 后的分支拓扑变化,以及 F1..F3 与 F1^..F3 区间范围的精确对比。
假设你的功能分支 feat 从 M1 分叉出来做了 F1 -> F2 -> F3,在此期间 main 往前推进了 M2。如果在 feat 上执行 git rebase main,Git 会先把 feat 相比于 main 多出来的 F1..F3 临时提取出来,随后将当前位置定在 M2,再依次把 F1、F2、F3 当作一次次 cherry-pick 重新放回 M2 末尾,生成全新哈希的 F1' -> F2' -> F3',最后把 feat 指针重新指向 F3'。原来在 M1 分叉出去的那条旧提交链不再被 feat 引用,整个分支历史变成了一条干净利落的直线。正因 rebase 底层与 cherry-pick 共用同一套逐个重放引擎,当 rebase 过程中某一步遇到冲突时,解决后使用的指令同样是 --continue、--abort 与 --skip。
把这三种跨分支整合操作放在同一张对比表中,各自的适用边界就非常清楚了:
| 对比维度 | git merge | git rebase | git cherry-pick |
|---|---|---|---|
| 设计目的 | 完整合入另一条分支的全部演化 | 把本地分支的起点挪到目标分支最新末端,整理为直线历史 | 仅复制其他分支中的 1 个或数个特定提交 |
| 搬运粒度 | 整条分支的所有提交 | 当前分支独有的整串提交 | 显式指定的单个提交或区间 |
| 是否生成新 Hash | 不改变已有节点,只新增 1 个合并节点 | 所有被重放的提交都会生成新 Hash | 被拣选重放的提交会生成新 Hash |
| 团队协作禁忌 | 公共分支与特性分支集成均可安全使用 | 严禁对已推送且有队友共用的分支执行变基 | 若整条分支随后仍需整体 merge,不要提前零散拣选 |
关于表格最后一行两条工程边界,需要格外留意:
rebase:因为 rebase 会生成一套全新哈希的提交来替换旧提交;如果你重写了公共分支历史并强制推送,其他人本地原有的提交记录就会与远程发生严重分叉冲突。日常安全做法是在自己的本地私有特性分支上用 git rebase main 同步主干更新,确认整洁无误后再合并入公共主干。cherry-pick,何时千万不要滥用:cherry-pick 最适合用在跨版本维护分支的缺陷修复同步(例如在 main 修完线上漏洞,顺手 cherry-pick -x 到还在维护的 release-1.0 分支),或者从一条准备废弃的实验分支中抢救某几个可用提交。但如果 feat-login 这条分支本身几天后就会通过 git merge 全部合入 main,就不要提前把里面的部分提交 cherry-pick 到 main——因为这会在两边同时留下代码相同但 Hash 不同的两份副本。虽然 rebase 具备识别相同补丁指纹并自动跳过的机制,但在常规 merge(以及代码托管平台上的 Pull Request 合并)中,这两份副本会保留在历史记录里,一旦后续两侧又碰巧改过这几行附近的代码,就极易诱发不必要的合并冲突。