Git整理(五) git cherry-pick的使用

概述
git cherry-pick能够理解为”挑拣”提交，它会获取某一个分支的单笔提交，并做为一个新的提交引入到你当前分支上。 当咱们须要在本地合入其余分支的提交时，若是咱们不想对整个分支进行合并，而是只想将某一次提交合入到本地当前分支上，那么就要使用git cherry-pick了。

用法
git cherry-pick [<options>] <commit-ish>...

经常使用options:
    --quit                退出当前的chery-pick序列
    --continue            继续当前的chery-pick序列
    --abort               取消当前的chery-pick序列，恢复当前分支
    -n, --no-commit       不自动提交
    -e, --edit            编辑提交信息
1
2
3
4
5
6
7
8
git cherry-pick commitid
在本地仓库中，有两个分支:branch1和branch2，咱们先来查看各个分支的提交：

# 切换到branch2分支
$ git checkout branch2
Switched to branch 'branch2'
$ 
$ 
# 查看最近三次提交
$ git log --oneline -3
23d9422 [Description]:branch2 commit 3
2555c6e [Description]:branch2 commit 2
b82ba0f [Description]:branch2 commit 1
# 切换到branch1分支
$ git checkout branch1
Switched to branch 'branch1'
# 查看最近三次提交
$ git log --oneline -3
20fe2f9 commit second
c51adbe commit first
ae2bd14 commit 3th
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
如今，我想要将branch2分支上的第一次提交内容合入到branch1分支上，则可使用git cherry-pick命令：

$ git cherry-pick 2555c6e
error: could not apply 2555c6e... [Description]:branch2 commit 2
hint: after resolving the conflicts, mark the corrected paths
hint: with 'git add <paths>' or 'git rm <paths>'
hint: and commit the result with 'git commit'
1
2
3
4
5
6
当cherry-pick时，没有成功自动提交，这说明存在冲突，所以首先须要解决冲突,解决冲突后须要git commit手动进行提交：

$ git commit 
[branch1 790f431] [Description]:branch2 commit 2
 Date: Fri Jul 13 18:36:44 2018 +0800
 1 file changed, 1 insertion(+)
 create mode 100644 only-for-branch2.txt
1
2
3
4
5
6
或者git add .后直接使用git cherry-pick --continue继续。 
如今查看提交信息：

$ git log --oneline -3
790f431 [Description]:branch2 commit 2
20fe2f9 commit second
c51adbe commit first
1
2
3
4
5
branch2分支上的第二次提交成功合入到了branch1分支上。

以上就是git cherry-pick的基本用法，若是没有出现冲突，该命令将自动提交。

git cherry-pick -n
若是不想git cherry-pick自动进行提交，则加参数-n便可。好比将branch2分支上的第三次提交内容合入到branch1分支上：

$ git cherry-pick 23d9422
[branch1 2c67715] [Description]:branch2 commit 3
 Date: Fri Jul 13 18:37:05 2018 +0800
 1 file changed, 1 insertion(+)
$ 
1
2
3
4
5
6
查看提交log,它自动合入了branch1分支：

$ git log --oneline -3
2c67715 [Description]:branch2 commit 3
f8bc5db [Description]:branch2 commit 2
20fe2f9 commit second
1
2
3
4
5
若是不想进行自动合入，则使用git cherry-pick -n：

# 回退上次提交，再此进行cherry-pick
$ git reset --hard HEAD~
HEAD is now at f8bc5db [Description]:branch2 commit 2
$ git cherry-pick -n 23d9422
$ git status
On branch branch1
Changes to be committed:
  (use "git reset HEAD <file>..." to unstage)

    modified:   only-for-branch2.txt

$ 
1
2
3
4
5
6
7
8
9
10
11
12
这时经过git status查看，发现已将branch2的提交获取可是没有合入。

git cherry-pick -e
若是想要在cherr-pick后从新编辑提交信息，则使用git cherry-pick -e命令，好比咱们仍是要将branch2分支上的第三次提交内容合入到branch1分支上，可是须要修改提交信息：

$ git cherry-pick -e 23d9422

  1 [Description]:branch2 commit 3
  2 #
  3 # It looks like you may be committing a cherry-pick.
  4 # If this is not correct, please remove the file
  5 #       .git/CHERRY_PICK_HEAD
  6 # and try again.
1
2
3
4
5
6
7
8
9
git cherry-pick –continue, –abort，–quit
当使用git cherry-pick发生冲突后,将会出现以下信息：

$ git cherry-pick 23d9422
error: could not apply 23d9422... [Description]:branch2 commit 3
hint: after resolving the conflicts, mark the corrected paths
hint: with 'git add <paths>' or 'git rm <paths>'
hint: and commit the result with 'git commit'
1
2
3
4
5
这时若是要继续cherry-pick，则首先须要解决冲突，经过git add .将文件标记为已解决，而后可使用git cherry-pick --continue命令，继续进行cherry-pick操做。

若是要中断此次cherry-pick,则使用git cherry-pick --quit，这种状况下当前分支中未冲突的内容状态将为modified，

若是要取消此次cherry-pick,则使用git cherry-pick --abort，这种状况下当前分支恢复到cherry-pick前的状态，没有改变。

git cherry-pick < branchname >
若是在git cherry-pick后加一个分支名，则表示将该分支顶端提交进cherry-pick，如：

$ git cherry-pick master
1
git cherry-pick ..< branchname >
git cherry-pick ^HEAD < branchname >
以上两个命令做用相同，表示应用全部提交引入的更改，这些提交是branchname的祖先但不是HEAD的祖先，好比，如今个人仓库中有三个分支，其提交历史以下图：

               C<---D<---E  branch2
              /
master   A<---B  
              \
               F<---G<---H  branch3
                         |
                         HEAD
1
2
3
4
5
6
7
若是我使用git cherry-pick ..branch2或者git cherry-pick ^HEAD branch2,那么会将属于branch2的祖先但不属于branch3的祖先的全部提交引入到当前分支branch3上，并生成新的提交，执行命令以下:

$ git cherry-pick ..branch2
[branch3 c95d8b0] [Description]:branch2  add only-for-branch2
 Date: Fri Jul 13 20:34:40 2018 +0800
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 only-for-branch2
[branch3 7199a67] [Description]:branch2 modify for only-for-branch2--1
 Date: Fri Jul 13 20:38:35 2018 +0800
 1 file changed, 1 insertion(+)
[branch3 eb8ab62] [Description]:branch2 modify for only-for-branch2--2
 Date: Fri Jul 13 20:39:09 2018 +0800
 1 file changed, 1 insertion(+)
1
2
3
4
5
6
7
8
9
10
11
执行后的提交历史以下：

               C<---D<---E  branch2
              /
master   A<---B  
              \
               F<---G<---H<---C'<---D'<---E'  branch3
                                          |
                                         HEAD
1
2
3
4
5
6
7
8
9
常见问题
1.The previous cherry-pick is now empty, possibly due to conflict resolution.
缘由:
在cherry-pick时出现冲突，解决冲突后本地分支中内容和cherry-pick以前相比没有改变，所以当在之后的步骤中继续git cherry-pick或执行其余命令时，因为此时还处于上次cherry-pick，都会提示该信息，表示多是因为解决冲突形成上一次cherry-pick内容是空的。

解决方案:
1.执行git cherry-pick --abort取消上次操做。

2.执行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: