在开发过程中,切换分支和合并代码是常用的操作,想想一种场景,在一个分支上进行了新版本开发,开发了若干新特性 featureD
、featureE
等等,但是需要变更,这个开发被搁置了,但是又想引入新的 featureD
特性,这个时候 cherry-pick
就是一个很有用的操作了。
介绍
git cherry-pick
命令用来将指定的 commit
应用到其它的分支。
下面以上面的例子介绍 cherry-pick
的使用,假设当前的分支状态如下图所示:
a - b #Main |
想要在主分支应用 featureD
特性,可以进行如下的操作:
$ git checkout main |
现在的分支状态变成了下面的结构:
a - b - D #Main |
使用
语法:
git cherry-pick ..
可以 cherry-pick
一个或多个提交。
git cherry-pick commitHashA..commitHashB
可以 cherry-pick 从 commitHashA
到 commitHashB
之间的所有提交,其中不包含 commitHashA
,包含 commitHashB
。
如:
# before |
git cherry-pick commitHashA^..commitHashB
同上面类似,区别在于包含 commitHashA
的提交:
# before |
git cherry-pick
可以将 <branchName>
上的最新提交 cherry-pick 到当前分支
几个有用的参数
-e 或 –edit
允许你在提交之前编辑提交消息。
-x
在原来的提交信息里追加一行 cherry picked from commit …
信息。
-m 或 –mainline
如果提交的是一个合并分支的提交,这个操作会失败,因为 cherry-pick
不知道选择那边的改动。
这个参数的作用就是告诉 cherry-pick
采用哪边的改动,通常不建议 cherry-pick
合并分支的提交。
-n 或 –no-commit
只应用指定提交的内容变更,但不会产生新的提交,即需要自己手动进行 git commit
的过程。
冲突处理
git cherry-pick (--continue | --skip | --abort | --quit) |
在 cherry-pick
过程中,有时候会有代码的冲突,这时 cherry-pick 的操作会暂停,可以选择如下操作:
git cherry-pick –continue
在解决冲突后,可以使用 git cherry-pick --continue
继续后面的 cherry-pick 过程。
git cherry-pick –skip
跳过当前的 commit
,继续后续的 cherry-pick 过程。
git cherry-pick –abort
放弃 cherry-pick,回到 cherry-pick 之前的状态。
git cherry-pick –quit
停止 cherry-pick,不回到 cherry-pick 之前的状态,保留现状。