Git实操：如何梳理存在大量cherry-pick的混乱分支提交历史

支持cherry-pick关联展示的可视化工具 #

• Git内置的日志可视化能力：执行git log --graph --oneline --decorate --cherry-mark --left-right master 分支A 分支B 分支C即可在命令行输出带提交关系图的日志，其中--cherry-mark参数会自动为改动内容完全一致的等价cherry-pick提交打上+/-标记，跨分支的同内容提交可以直接被识别，不依赖提交信息里的溯源标记。
• GitKraken：本地客户端的提交图默认内置等价提交识别逻辑，会在跨分支的cherry-pick关联提交之间绘制灰色虚线连线，只要提交的代码改动内容一致就能匹配，不需要额外配置规则。
• SourceTree：在提交视图的设置选项中开启「显示匹配的cherry-pick提交」开关后，会自动对跨分支内容一致的提交做高亮关联，不需要手动导出日志做比对。

Git log识别cherry-pick提交的相关参数 #

• 针对加了-x参数执行的标准cherry-pick操作：这类操作生成的提交会在提交说明尾部自动追加(cherry picked from commit <原始提交SHA>)的trailer行，可以直接用自定义格式提取原始SHA，不需要手动grep匹配，示例命令：

  git log --format="%h %d %s | 原始cherry-pick来源: %(trailers:key=cherry picked from commit,valueonly)"
  

  命令执行后，非cherry-pick生成的提交对应的原始来源字段为空，带溯源标记的cherry-pick提交会直接展示原始提交的SHA值。
• 快速筛选所有带官方溯源标记的cherry-pick提交，可以直接用：

  git log --grep="cherry picked from commit" --oneline
  

• 针对未加-x、提交信息里没有溯源标记的cherry-pick，没有直接的log格式参数可以标记，但是可以通过git patch-id计算提交的内容哈希（忽略提交SHA、提交时间、提交人等元数据，仅校验代码改动内容），patch-id完全一致的提交即为cherry-pick生成的等价提交，这种方式比匹配提交信息的准确率高很多，不会因为cherry-pick时修改了提交信息就漏判。

大量cherry-pick场景下的历史梳理实用方案 #

• 不要先逐分支导出日志靠提交信息做匹配，优先做等价提交归并：批量拉取所有分支（含master）的全量提交，对每个提交计算patch-id，将patch-id相同的提交归为同一改动组，只要组内任意一个提交存在于master的提交历史中，即可判定该改动已经正式合入master，不需要重复核对内容。
• 梳理前先对齐master基线：先把master上所有提交的patch-id存入集合，逐个扫描其余分支的提交，patch-id命中master集合的直接标记为「已合入」，剩余未命中的就是各分支独有的未合入提交，这部分再单独判断是需要合入、废弃还是重新整理。
• 用原生命令替代自定义脚本做分支差异比对：git cherry <目标分支> <源分支>命令会自动对两个分支的提交做patch-id匹配，输出结果中前缀为-的提交代表该改动已经通过cherry-pick等方式存在于目标分支，前缀为+的代表是源分支独有的未合入改动，不需要自己写脚本做字符串匹配。
• 不要用提交时间判断提交的先后顺序：cherry-pick生成的新提交的时间是执行cherry-pick操作的时间，和原始提交的时间可能相差数周甚至数月，时间线完全没有参考价值，所有合入状态的判断都要以内容匹配结果为准。
• 梳理完成后做历史对齐时，尽量将零散的cherry-pick提交替换为正规的merge或者rebase提交，对之前没有留溯源标记的cherry-pick提交可以补打说明，避免后续再出现溯源链路断裂的问题。

内容的提问来源于stack exchange，提问作者rimiha