git cherry pick
概述
对于多分支的代码库,将提交记录从一个分支转移到另一个分支是常见需求。这时分两种情况:
- 需要另一个分支的所有提交记录,使用合并(git merge)
- 只需要部分提交记录,可使用cherry pick。
命令
git cherry pick是一个很强大的命令,支持从某次、多次提交、多次连续提交、分支及其他远程仓库中进行代码的应用操作。
- 某次提交
$ git cherry-pick <commitHash>
将指定的提交应用于当前分支。这会在当前分支产生一个新的提交,当然它们的哈希值会不一样。 - 某个分支
$ git cherry-pick <branch>
将指定分支的最后一次提交,应用到当前分支。 - 多次提交
$ git cherry-pick <HashA> <HashB>
将A和B两个提交应用到当前分支。这会在当前分支生成两个对应的新提交。 - 连续多次提交
$ git cherry-pick A..B
将从A(不包括A提交记录)到B的所有提交应用到当前分支,A提交必须要早于B提交。
$ git cherry-pick A^..B
将从A(包括A提交记录)到B的所有提交应用到当前分支,A提交必须要早于B提交。 - 其他远程仓库
Cherry pick 也支持转移另一个代码库的提交,方法是先将该库加为远程仓库。
$ git remote add target git://gitUrl
将远程代码抓取到本地。
$ git fetch target
检查一下要从远程仓库转移的提交,获取它的哈希值。
$ git log target/master
最后,使用git cherry-pick命令转移提交。
$ git cherry-pick <commitHash>
选项
-e
,--edit
打开外部编辑器,编辑提交信息。-n
,--no-commit
只更新工作区和暂存区,不产生新的提交。-x
在提交信息的末尾追加一行(cherry picked from commit …),方便追溯提交记录。-s
,--signoff
在提交信息的末尾追加一行操作者的签名。-m parent-number
,--mainline parent-number
如果原始提交是一个合并节点,来自于两个分支的合并,那么 Cherry pick 默认将失败,因为它不知道应该采用哪个分支的代码变动。
-m配置项告诉 Git,应该采用哪个分支的变动。它的参数parent-number
是一个从1开始的整数,代表原始提交的父分支编号。
$ git cherry-pick -m 1 <commitHash>
上面命令表示,Cherry pick 采用提交commitHash来自编号1的父分支的变动。
一般来说,1号父分支是接受变动的分支(the branch being merged into),2号父分支是作为变动来源的分支(the branch being merged from)。
代码冲突
如果操作过程中发生代码冲突,cherry-pick会被中断,让用户决定如何继续操作。
--continue
解决代码冲突后,将修改的文件重新加入暂存区(git add .
),让cherry pick过程继续执行:
$ git cherry-pick --continue
--abort
发生代码冲突后,放弃合并,回到操作前的样子。--quit
发生代码冲突后,退出 Cherry pick,但是不回到操作前的样子。
常见问题
1.The previous cherry-pick is now empty, possibly due to conflict resolution.
原因:在cherry-pick时出现冲突,解决冲突后本地分支中内容和cherry-pick之前相比没有改变,因此当在以后的步骤中继续git cherry-pick或执行其他命令时,由于此时还处于上次cherry-pick,都会提示该信息,表示可能是由于解决冲突造成上一次cherry-pick内容是空的。
解决方案:
- 执行
git cherry-pick --abort
取消上次操作 - 执行
git commit --allow-empty
,表示允许空提交。
2.fatal: You are in the middle of a cherry-pick – cannot amend.
原因:在cherry-pick时出现冲突,没有解决冲突就执行git commit --amend
命令,从而会提示该信息。
解决方案:在git commit --amend
之前解决冲突,并完成这次cherry-pick:
$ git add .
$ git cherry-pick --continue
参考
https://www.git-scm.com/docs/git-cherry-pick
https://zhuanlan.zhihu.com/p/90816644