企业官网建设流程全解析

• 文档
• 教程
• 知识库

git cherry-pick不止能针对单个提交，还可以一次性地把一段连续的提交序列应用到当前分支上，其核心语法与git log等命令通用的点号区间（dotted range）记法一脉相承。本文以 TIL 仓库中 cherry-pick-a-range-of-commits.md 为线索，系统讲解用A..B与B^..D语法挑选提交范围的原理、边界行为（下界开区间 vs 上界闭区间）以及配套的实用技巧，读完即可在日常分支管理中精准、安全地批量移植提交。

核心概念：cherry-pick 与提交范围

git cherry-pick的官方语义是「给定一个或多个已存在的提交，将其中每一个引入的变更应用出来，并为每一个提交记录一个新提交」。因此它天然支持一次处理多个提交——既可以像 cherry-pick-multiple-commits-at-once.md 中那样显式列出多个 SHA：

$ git cherry-pick 5206af5 6362f41

也可以直接传入一个提交范围，让 Git 替你枚举该区间内的全部提交并逐一应用。后者正是本主题的用武之地：当你想把某个分支上一段连续的改动原样搬到另一个分支（例如把 hotfix 分支的连续三个修复提交移植到主干），范围语法远比逐个抄写 SHA 高效、不易出错。

范围语法A..B：上界包含、下界排除

Git 的A..B双点记法在git log、git diff、git rev-list等命令中随处可见（参见 two-kinds-of-dotted-range-notation.md）。把它用在git cherry-pick上时，语义完全一致：

• A是范围较旧的一端，且该端点本身被排除（开区间下界）；
• B是范围较新的一端，且该端点本身被包含（闭区间上界）。

考虑一条如下的提交链：A - B - C - D（越靠右越新，D为最新）。执行：

$ git cherry-pick B..D

实际被挑选到HEAD上的是提交C和D，而B不会进入结果。原因正是上面说的：下界是排他的（exclusive），区间只覆盖「B 之后、直到并包括 D」的提交。

小贴士：若此时还希望把B本身也一并带上，就把下界再往前推一位，写成B^..D（见下文）。这一点与git log A..B的结果边界完全一致——同样的记法在整个 Git 生态中保持统一，理解了其一即可举一反三。

下界前移：B^..D把起点也包含进来

当范围下界被排除时，如何「补上」那个被跳过的提交？答案是使用^符号引用下界提交的父提交。B^表示提交B的第一个父提交，也就是链中的A。于是：

$ git cherry-pick B^..D

等价于「从B^（即A）之后开始、直到并包含D」，正好把A - B - C - D链中的B、C、D三个提交全部挑选出来，同时仍不包含A。

这一技巧在以下场景尤其好用：

• 你想迁移的「第一个提交」本身就在区间端点位置上，而你又不想把它的父提交一起带过来；
• 你只记得区间两端的 SHA，却记不清中间到底有几个提交——用B..D和B^..D可以放心地表达「去掉开头 vs 包含开头」两种意图，而不必逐一核对中间提交；
• 与 checking-commit-ancestry.md 中git merge-base --is-ancestor的思路配合，先确认端点提交的祖先关系，再放心批量挑选。

一次性应用多个提交时的实际行为

范围语法本质上等价于把区间内的提交逐个交给 cherry-pick。参考 cherry-pick-multiple-commits-at-once.md 展示的多提交输出，命令会按顺序逐个应用并各自生成新提交，自动合并时还会打印Auto-merging与对应的新提交摘要：

$ git cherry-pick 5206af5 6362f41 Auto-merging test/services/event_test.rb [jb/my-feature-branch 961f3deb] Use the other testing syntax Date: Fri May 2 10:50:14 2025 -0500 1 file changed, 7 insertions(+), 7 deletions(-)

对范围形式git cherry-pick B..D而言，输出模式完全相同：C的变更先应用并生成一个新提交，接着D的变更再应用并再生成一个新提交，两条新提交依次叠在HEAD之上。这意味着：

• 挑选后的提交不会保留原提交的 SHA，而是获得全新的提交对象；
• 提交的作者信息、提交时间会按默认行为保留原始值（除非使用-e编辑或--no-commit等选项调整）；
• 如果中间某个提交无法干净合并，cherry-pick 会停下来等待人工解决冲突，解决后可用git cherry-pick --continue继续，或用--abort整体放弃。

合并冲突与常用配套选项

范围挑选本质上是多次逐个合并，因此冲突概率随提交数量上升。若遇到「近乎可合并但边界微妙」的情况，可考虑在挑选时施加与git diff一致的合并策略，例如 diffing-with-patience.md 提到的 patience 算法：

$ git cherry-pick -Xpatience B..D

-Xpatience会把 patience 作为底层合并策略传入，对「大量重复行」「行被移位」这类容易误判的场景通常能得到更合理的冲突结果。除此之外，man git-cherry-pick中值得留意的选项还包括：

需要特别提醒：默认情况下不能直接对合并提交执行 cherry-pick，除非用-m指明父提交编号——这同样是范围挑选中可能遇到的一个坑。

范围记法与分支对比的联动理解

理解了A..B的边界语义后，可以顺带把它与仓库中其他 Git 条目打通，形成完整的知识闭环：

• list-commits-on-a-branch.md 使用git log master..my-feature-branch列出「在功能分支上、但不在 master 上」的提交——与git cherry-pick master..my-feature-branch的挑选对象完全对应，可以先用git log --oneline预览将要挑选的提交清单，再执行挑选；
• two-kinds-of-dotted-range-notation.md 区分了..与...（三点对称差）两种记法，cherry-pick 场景下使用..即可，...主要用于git log --left-right --cherry-pick这类双向对比（见 list-different-commits-between-two-branches.md）；
• transition-a-branch-from-one-base-to-another.md 提供了「换基准」的另一种思路：若想整段迁移某个分支而不是挑选零散提交，用git rebase --onto dev main my-feature-branch更干净——范围 cherry-pick 与--ontorebase 各有所长，前者适合把提交「复制一份」到别处并保留原分支，后者适合「整体挪动」分支基线；
• accessing-a-lost-commit.md 展示了一个典型组合拳：通过git reflog找回丢失提交的 SHA 后，可以顺手用git cherry-pick把它恢复回来。

实战演练：一条可复现的完整流程

把以上知识串成一个可直接照做的实验（建议在临时分支上操作，避免影响真实历史）：

# 1. 构造一条 A-B-C-D 提交链 git checkout -b demo-base git commit --allow-empty -m "A" # 记为 A git commit --allow-empty -m "B" # 记为 B git commit --allow-empty -m "C" # 记为 C git commit --allow-empty -m "D" # 记为 D # 2. 用 --oneline 预览范围：只会列出 C 与 D git log B..D --oneline # 3. 把 C、D 挑选到当前分支（示例从 demo-base 上另开一个分支） git checkout -b demo-target git cherry-pick B..D # 4. 若想把 B 也包含进来，下界前移到 B^ git cherry-pick B^..D # 5. 挑选结束后，检查新提交及来源 git log --oneline -5

第 2 步的git log B..D --oneline是与git cherry-pick B..D完全同源的预览手段——先看清单、再执行挑选，是规避误选的最佳习惯。

总结

• git cherry-pick A..B会把A之后、直到并包含B的全部提交逐个应用到当前分支，其中下界A本身被排除；
• 需要连下界一起挑选时，用B^..D把起点前移到父提交，即可包含B；
• 范围挑选逐提交生成新提交，冲突时可用-Xpatience、--continue/--abort等选项控制流程；
• 更全面的语法与选项细节，以man git-cherry-pick及man git-rev-parse（范围记法的权威来源）为准。

本主题来自 TIL 仓库的 cherry-pick-a-range-of-commits.md，并交叉印证了仓库内 cherry-pick-multiple-commits-at-once.md、two-kinds-of-dotted-range-notation.md、list-commits-on-a-branch.md 等条目；如需继续深入，可在仓库 git 目录 下检索更多 cherry-pick 与范围记法相关的实战笔记。

• 文档
• 教程
• 知识库