概述
git cherry-pick能夠理解爲」挑揀」提交,它會獲取某一個分支的單筆提交,並做爲一個新的提交引入到你當前分支上。 當咱們須要在本地合入其餘分支的提交時,若是咱們不想對整個分支進行合併,而是隻想將某一次提交合入到本地當前分支上,那麼就要使用git cherry-pick了。git
用法
git cherry-pick [<options>] <commit-ish>...app
經常使用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,咱們先來查看各個分支的提交:ui
# 切換到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命令:this
$ 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手動進行提交:.net
$ 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繼續。
如今查看提交信息:3d
$ git log --oneline -3
790f431 [Description]:branch2 commit 2
20fe2f9 commit second
c51adbe commit first
1
2
3
4
5
branch2分支上的第二次提交成功合入到了branch1分支上。blog
以上就是git cherry-pick的基本用法,若是沒有出現衝突,該命令將自動提交。ip
git cherry-pick -n
若是不想git cherry-pick自動進行提交,則加參數-n便可。好比將branch2分支上的第三次提交內容合入到branch1分支上:rem
$ 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分支:it
$ 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: