git cherry-pick的使用教程

对于多分支的代码库，将代码从一个分支转移到另外一个分支是常见需求。git

这时分两种状况。一种状况是，你须要另外一个分支的全部代码变更，那么就采用合并（git merge）。另外一种状况是，你只须要部分代码变更（某几个提交），这时能够采用 Cherry pick。编辑器

1、基本用法

git cherry-pick命令的做用，就是将指定的提交（commit）应用于其余分支。测试

$ git cherry-pick <commitHash>

上面命令就会将指定的提交commitHash，应用于当前分支。这会在当前分支产生一个新的提交，固然它们的哈希值会不同。fetch

举例来讲，代码仓库有master和feature两个分支。ui

a - b - c - d   Master
         \
           e - f - g Feature

如今将提交f应用到master分支。spa

# 切换到 master 分支
$ git checkout master

# Cherry pick 操做
$ git cherry-pick f

上面的操做完成之后，代码库就变成了下面的样子。code

a - b - c - d - f   Master
         \
           e - f - g Feature

从上面能够看到，master分支的末尾增长了一个提交f。blog

git cherry-pick命令的参数，不必定是提交的哈希值，分支名也是能够的，表示转移该分支的最新提交。rem

$ git cherry-pick feature

上面代码表示将feature分支的最近一次提交，转移到当前分支。get

2、转移多个提交

Cherry pick 支持一次转移多个提交。（亲测试ok）

$ git cherry-pick <HashA> <HashB>

上面的命令将 A 和 B 两个提交应用到当前分支。这会在当前分支生成两个对应的新提交。

若是想要转移一系列的连续提交，可使用下面的简便语法。

$ git cherry-pick A..B

上面的命令能够转移从 A 到 B 的全部提交。它们必须按照正确的顺序放置：提交 A 必须早于提交 B，不然命令将失败，但不会报错。

注意，使用上面的命令，提交 A 将不会包含在 Cherry pick 中。若是要包含提交 A，可使用下面的语法。

$ git cherry-pick A^..B

3、配置项

git cherry-pick命令的经常使用配置项以下。

（1）-e，--edit

打开外部编辑器，编辑提交信息。

（2）-n，--no-commit

只更新工做区和暂存区，不产生新的提交。

（3）-x

在提交信息的末尾追加一行(cherry picked from commit ...)，方便之后查到这个提交是如何产生的。

（4）-s，--signoff

在提交信息的末尾追加一行操做者的签名，表示是谁进行了这个操做。

（5）-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）。

4、代码冲突

若是操做过程当中发生代码冲突，Cherry pick 会停下来，让用户决定如何继续操做。

（1）--continue

用户解决代码冲突后，第一步将修改的文件从新加入暂存区（git add .），第二步使用下面的命令，让 Cherry pick 过程继续执行。

$ git cherry-pick --continue

（2）--abort

$ git cherry-pick --abort

发生代码冲突后，放弃合并，回到操做前的样子。

（3）--quit

发生代码冲突后，退出 Cherry pick，可是不回到操做前的样子。

5、转移到另外一个代码库

Cherry pick 也支持转移另外一个代码库的提交，方法是先将该库加为远程仓库。

$ git remote add target git://gitUrl

上面命令添加了一个远程仓库target。

而后，将远程代码抓取到本地。

$ git fetch target

上面命令将远程代码仓库抓取到本地。

接着，检查一下要从远程仓库转移的提交，获取它的哈希值。

$ git log target/master

最后，使用git cherry-pick命令转移提交。

$ git cherry-pick <commitHash>