在版本控制系統(tǒng)中摸索前進(jìn)是一件很棘手的事情。對于一個新手來說，這可能是非常難以應(yīng)付的，但熟悉版本控制系統(tǒng)(如 Git)的術(shù)語和基礎(chǔ)知識是開始為開源貢獻(xiàn)的第一步。

熟悉 Git 也能幫助你在開源之路上走出困境。Git 功能強(qiáng)大，讓你感覺自己在掌控之中 —— 沒有哪一種方法會讓你無法恢復(fù)到工作版本。

[[393739]]

這里有一個例子可以幫助你理解“遴選cherry-pick”的重要性。假設(shè)你已經(jīng)在一個分支上做了好幾個提交，但你意識到這是個錯誤的分支!你現(xiàn)在該怎么辦?你現(xiàn)在要做什么?要么在正確的分支上重復(fù)所有的變更，然后重新提交，要么把這個分支合并到正確的分支上。等一下，前者太過繁瑣，而你可能不想做后者。那么，還有沒有辦法呢?有的，Git 已經(jīng)為你準(zhǔn)備好了。這就是“遴選”的作用。顧名思義，你可以用它從一個分支中手工遴選一個提交，然后轉(zhuǎn)移到另一個分支。

使用遴選的原因有很多。以下是其中的三個原因。

避免重復(fù)性工作

如果你可以直接將相同的提交復(fù)制到另一個分支，就沒有必要在不同的分支中重做相同的變更。請注意，遴選出來的提交會在另一個分支中創(chuàng)建帶有新哈希的新提交，所以如果你看到不同的提交哈希，請不要感到困惑。

如果您想知道什么是提交的哈希，以及它是如何生成的，這里有一個說明可以幫助你。提交哈希是用 SHA-1 算法生成的字符串。SHA-1 算法接收一個輸入，然后輸出一個唯一的 40 個字符的哈希值。如果你使用的是 POSIX 系統(tǒng)，請嘗試在您的終端上運(yùn)行這個命令：

$ echo -n "commit" | openssl sha1 

這將輸出一個唯一的 40 個字符的哈希值 4015b57a143aec5156fd1444a017a32137a3fd0f。這個哈希代表了字符串 commit。

Git 在提交時生成的 SHA-1 哈希值不僅僅代表一個字符串。它代表的是：

sha1( 
    meta data 
        commit message 
        committer 
        commit date 
        author 
        authoring date 
    Hash of the entire tree object 
) 

這就解釋了為什么你對代碼所做的任何細(xì)微改動都會得到一個獨(dú)特的提交哈希值。哪怕是一個微小的改動都會被發(fā)現(xiàn)。這是因為 Git 具有完整性。

撤銷/恢復(fù)丟失的更改

當(dāng)你想恢復(fù)到工作版本時，遴選就很方便。當(dāng)多個開發(fā)人員在同一個代碼庫上工作時，很可能會丟失更改，最新的版本會被轉(zhuǎn)移到一個陳舊的或非工作版本上。這時，遴選提交到工作版本就可以成為救星。

它是如何工作的?

假設(shè)有兩個分支：feature1 和 feature2，你想把 feature1 中的提交應(yīng)用到 feature2。

在 feature1 分支上，運(yùn)行 git log 命令，復(fù)制你想遴選的提交哈希值。你可以看到一系列類似于下面代碼示例的提交。commit 后面的字母數(shù)字代碼就是你需要復(fù)制的提交哈希。為了方便起見，您可以選擇復(fù)制前六個字符(本例中為 966cf3)。

commit 966cf3d08b09a2da3f2f58c0818baa37184c9778 (HEAD -> master) 
Author: manaswinidas <me@example.com> 
Date:   Mon Mar 8 09:20:21 2021 +1300 
   add instructions 

然后切換到 feature2 分支，在剛剛從日志中得到的哈希值上運(yùn)行 git cherry-pick：

$ git checkout feature2 
$ git cherry-pick 966cf3. 

如果該分支不存在，使用 git checkout -b feature2 來創(chuàng)建它。

這里有一個問題。你可能會遇到下面這種情況：

$ git cherry-pick 966cf3 
On branch feature2 
You are currently cherry-picking commit 966cf3d. 
nothing to commit, working tree clean 
The previous cherry-pick is now empty, possibly due to conflict resolution. 
If you wish to commit it anyway, use: 
   git commit --allow-empty 
Otherwise, please use 'git reset' 

不要驚慌。只要按照建議運(yùn)行 git commit --allow-empty：

$ git commit --allow-empty 
[feature2 afb6fcb] add instructions 
Date: Mon Mar 8 09:20:21 2021 +1300 

這將打開你的默認(rèn)編輯器，允許你編輯提交信息。如果你沒有什么要補(bǔ)充的，可以保存現(xiàn)有的信息。

就這樣，你完成了你的第一次遴選。如上所述，如果你在分支 feature2 上運(yùn)行 git log，你會看到一個不同的提交哈希。下面是一個例子：

commit afb6fcb87083c8f41089cad58deb97a5380cb2c2 (HEAD -> feature2) 
Author: manaswinidas <[me@example.com][4]> 
Date:   Mon Mar 8 09:20:21 2021 +1300 
   add instructions 

不要對不同的提交哈希感到困惑。這只是區(qū)分 feature1 和 feature2 的提交。

遴選多個提交

但如果你想遴選多個提交的內(nèi)容呢?你可以使用：

git cherry-pick <commit-hash1> <commit-hash2>... <commit-hashn> 

請注意，你不必使用整個提交的哈希值，你可以使用前五到六個字符。

同樣，這也是很繁瑣的。如果你想遴選的提交是一系列的連續(xù)提交呢?這種方法太費(fèi)勁了。別擔(dān)心，有一個更簡單的方法。

假設(shè)你有兩個分支：

• feature1 包括你想復(fù)制的提交(從更早的 commitA 到 commitB)。
• feature2 是你想把提交從 feature1 轉(zhuǎn)移到的分支。

然后：

• 輸入 git checkout 。
• 獲取 commitA 和 commitB 的哈希值。
• 輸入 git checkout 。
• 輸入 git cherry-pick ^.. (請注意，這包括 commitA 和 commitB)。
• 如果遇到合并沖突，像往常一樣解決，然后輸入 git cherry-pick --continue 恢復(fù)遴選過程。

重要的遴選選項

以下是 Git 文檔 中的一些有用的選項，你可以在 cherry-pick 命令中使用。

• -e、--edit：用這個選項，git cherry-pick 可以讓你在提交前編輯提交信息。
• -s、--signoff：在提交信息的結(jié)尾添加 Signed-off by 行。更多信息請參見 git-commit(1) 中的 signoff 選項。
• -S[]、--pgg-sign[=]：這些是 GPG 簽名的提交。keyid 參數(shù)是可選的，默認(rèn)為提交者身份;如果指定了，則必須嵌在選項中，不加空格。
• --ff：如果當(dāng)前 HEAD 與遴選的提交的父級提交相同，則會對該提交進(jìn)行快進(jìn)操作。

下面是除了 --continue 外的一些其他的后繼操作子命令：

• --quit：你可以忘記當(dāng)前正在進(jìn)行的操作。這可以用來清除遴選或撤銷失敗后的后繼操作狀態(tài)。
• --abort：取消操作并返回到操作序列前狀態(tài)。

下面是一些關(guān)于遴選的例子：

• git cherry-pick master：應(yīng)用 master 分支頂端的提交所引入的變更，并創(chuàng)建一個包含該變更的新提交。
• git cherry-pick master~4 master~2'：應(yīng)用master` 指向的第五個和第三個最新提交所帶來的變化，并根據(jù)這些變化創(chuàng)建兩個新的提交。

感到不知所措?你不需要記住所有的命令。你可以隨時在你的終端輸入 git cherry-pick --help 查看更多選項或幫助。