cherry-pick 冲突本质是补丁无法干净应用,而非代码错误;它将源提交与其父提交的 diff 应用到当前 HEAD,若目标分支在相同文件邻近位置有修改(如空行、缩进、函数变动或文件重命名),或缺失依赖提交,即触发冲突,需手动解决并执行 git add 和 git cherry-pick --continue。

cherry-pick 冲突不是代码写错了,而是 Git 在“打补丁”时发现目标位置和源提交的上下文对不上——必须手动告诉它保留哪部分逻辑。
为什么明明没改同一行,却报 conflict?
cherry-pick 的本质是把 a1b2c3d 这次提交相对于其父提交的 diff,应用到当前分支 HEAD 上。如果目标分支在相同文件、相近位置已有其他修改(哪怕只是空行增删、缩进变化),Git 就无法自动判断该“套用”还是“跳过”。这和 merge 冲突不同,它不依赖共同祖先,只看 patch 能否干净打上。
- 常见诱因:目标分支已修改了被 pick 文件的邻近函数、新增了同名变量、或重命名了该文件但 cherry-pick 仍按原路径找
- 树冲突(
deleted by us)比内容冲突更隐蔽:比如源提交改了utils.js,而目标分支里它已被重命名为helpers.js,Git 不会自动映射 - 历史冲突容易被忽略:如果
a1b2c3d依赖前一个提交里定义的常量,而那个提交没被 pick,冲突可能出现在看似无关的多处文件中
git status 和 git diff 看什么?
执行 git cherry-pick a1b2c3d 报错后,先别急着改代码:
-
git status会列出所有状态为both modified的文件,这些就是冲突文件;同时你会看到提示CHERRY_PICK_HEAD is now at a1b2c3d... -
git diff显示的是工作区与索引的差异(即你还没git add的修改),此时它展示的是冲突标记区域 —— 注意看和 <code>>>>>>> a1b2c3d之间的内容 - 想对比原始 patch 长什么样?运行
git show a1b2c3d -- file.js,这是你真正要“移植”的变更
解决完冲突后,别漏掉这两步
手动编辑完冲突文件、删掉所有 /<code>=======/>>>>>> 标记后,不能直接 git commit:
- 必须对每个已解决的文件执行
git add file.js—— 否则 Git 不认为冲突已处理,git cherry-pick --continue会拒绝执行 - 执行
git cherry-pick --continue才会真正生成新 commit;如果中途想放弃,用git cherry-pick --abort(它会还原到 cherry-pick 前的状态) - 如果只想跳过当前这个冲突提交,用
git cherry-pick --skip,但要注意后续提交可能因缺失依赖而继续失败
批量 cherry-pick 时冲突更难缠
当你运行 git cherry-pick a1b2c3d b4c5d6e f7g8h9i,Git 是逐个顺序应用的。第一个冲突卡住后,后面两个根本不会开始处理。更麻烦的是:
- 如果
b4c5d6e依赖a1b2c3d的改动,而你--skip了前者,后者大概率也会失败 - 用范围语法
git cherry-pick A..B时,A 是排除项,B 是终点 —— 但若中间某个提交冲突,整个序列中断,不会自动停在第一个失败处 - 建议拆成单次操作:先
git cherry-pick a1b2c3d,解决完再git cherry-pick b4c5d6e,可控性高得多
最常被忽略的一点:cherry-pick 生成的新 commit 哈希值和原提交完全不同,且父提交是当前分支的 HEAD。这意味着——如果你之后要在其他分支上复用这个修复,别再用原哈希去 cherry-pick,得用这次新生成的哈希,否则会重复引入甚至造成环状依赖。


















