git cherry-pick
能夠理解爲」挑揀」提交,它會獲取某一個分支的單筆提交,並做爲一個新的提交引入到你當前分支上。 當咱們須要在本地合入其餘分支的提交時,若是咱們不想對整個分支進行合併,而是隻想將某一次提交合入到本地當前分支上,那麼就要使用git cherry-pick
了。git
git cherry-pick [<options>] <commit-ish>...
經常使用options:
--quit 退出當前的chery-pick序列
--continue 繼續當前的chery-pick序列
--abort 取消當前的chery-pick序列,恢復當前分支
-n, --no-commit 不自動提交
-e, --edit 編輯提交信息
在本地倉庫中,有兩個分支:branch1和branch2,咱們先來查看各個分支的提交:bash
# 切換到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
如今,我想要將branch2分支上的第一次提交內容合入到branch1分支上,則可使用git cherry-pick
命令:markdown
$ 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'
當cherry-pick
時,沒有成功自動提交,這說明存在衝突,所以首先須要解決衝突,解決衝突後須要git commit
手動進行提交:app
$ 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
或者git add .
後直接使用git cherry-pick --continue
繼續。 post
如今查看提交信息:ui
$ git log --oneline -3 790f431 [Description]:branch2 commit 2 20fe2f9 commit second c51adbe commit first
branch2分支上的第二次提交成功合入到了branch1分支上。this
以上就是git cherry-pick
的基本用法,若是沒有出現衝突,該命令將自動提交。spa
若是不想git cherry-pick
自動進行提交,則加參數-n
便可。好比將branch2分支上的第三次提交內容合入到branch1分支上:.net
$ git cherry-pick 23d9422 [branch1 2c67715] [Description]:branch2 commit 3 Date: Fri Jul 13 18:37:05 2018 +0800 1 file changed, 1 insertion(+) $
查看提交log,它自動合入了branch1分支:3d
$ git log --oneline -3 2c67715 [Description]:branch2 commit 3 f8bc5db [Description]:branch2 commit 2 20fe2f9 commit second
若是不想進行自動合入,則使用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
這時經過git status
查看,發現已將branch2的提交獲取可是沒有合入。
若是想要在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.
當使用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'
這時若是要繼續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
後加一個分支名,則表示將該分支頂端提交進cherry-pick,如:
$ git cherry-pick master
以上兩個命令做用相同,表示應用全部提交引入的更改,這些提交是branchname的祖先但不是HEAD的祖先,好比,如今個人倉庫中有三個分支,其提交歷史以下圖:
C<---D<---E branch2 / master A<---B \ F<---G<---H branch3 | HEAD
若是我使用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(+)
執行後的提交歷史以下:
C<---D<---E branch2
/
master A<---B
\
F<---G<---H<---C'<---D'<---E' branch3 | HEAD
在cherry-pick
時出現衝突,解決衝突後本地分支中內容和cherry-pick
以前相比沒有改變,所以當在之後的步驟中繼續git cherry-pick
或執行其餘命令時,因爲此時還處於上次cherry-pick
,都會提示該信息,表示多是因爲解決衝突形成上一次cherry-pick內容是空的。
1.執行git cherry-pick --abort
取消上次操做。
2.執行git commit --allow-empty
,表示容許空提交。
在cherry-pick
時出現衝突,沒有解決衝突就執行git commit --amend
命令,從而會提示該信息。
首先在git commit --amend
以前解決衝突,並完成此次cherry-pick
:
$ git add . $ git cherry-pick --continue