git cherry-pick詳解

對於多分支的代碼庫,將代碼從一個分支轉移到另一個分支是常見需求。

這時分兩種情況。一種情況是,你需要另一個分支的所有代碼變動,那麼就採用合併(git merge)。另一種情況是,你只需要部分代碼變動(某幾個提交),這時可以採用 Cherry pick。

一、基本用法

git cherry-pick命令的作用,就是將指定的提交(commit)應用於其他分支。


$ git cherry-pick <commitHash>

上面命令就會將指定的提交commitHash,應用於當前分支。這會在當前分支產生一個新的提交,當然它們的哈希值會不一樣。

舉例來說,代碼倉庫有masterfeature兩個分支。


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

現在將提交f應用到master分支。


# 切換到 master 分支
$ git checkout master

# Cherry pick 操作
$ git cherry-pick f

上面的操作完成以後,代碼庫就變成了下面的樣子。


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

從上面可以看到,master分支的末尾增加了一個提交f

git cherry-pick命令的參數,不一定是提交的哈希值,分支名也是可以的,表示轉移該分支的最新提交。


$ git cherry-pick feature

上面代碼表示將feature分支的最近一次提交,轉移到當前分支。

二、轉移多個提交

Cherry pick 支持一次轉移多個提交。


$ 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 

三、配置項

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)。

四、代碼衝突

如果操作過程中發生代碼衝突,Cherry pick 會停下來,讓用戶決定如何繼續操作。

(1)--continue

用戶解決代碼衝突後,第一步將修改的文件重新加入暫存區(git add .),第二步使用下面的命令,讓 Cherry pick 過程繼續執行。


$ git cherry-pick --continue

(2)--abort

發生代碼衝突後,放棄合併,回到操作前的樣子。

(3)--quit

發生代碼衝突後,退出 Cherry pick,但是不回到操作前的樣子。

五、轉移到另一個代碼庫

Cherry pick 也支持轉移另一個代碼庫的提交,方法是先將該庫加爲遠程倉庫。


$ git remote add target git://gitUrl

上面命令添加了一個遠程倉庫target

然後,將遠程代碼抓取到本地。


$ git fetch target

上面命令將遠程代碼倉庫抓取到本地。

接着,檢查一下要從遠程倉庫轉移的提交,獲取它的哈希值。


$ git log target/master

最後,使用git cherry-pick命令轉移提交。


$ git cherry-pick <commitHash>
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章