分支的新建與合并

現(xiàn)在讓我們來看一個簡單的分支與合并的例子，實際工作中大體也會用到這樣的工作流程：

1. 開發(fā)某個網(wǎng)站。
2. 為實現(xiàn)某個新的需求，創(chuàng)建一個分支。
3. 在這個分支上開展工作。

假設(shè)此時，你突然接到一個電話說有個很嚴(yán)重的問題需要緊急修補(bǔ)，那么可以按照下面的方式處理：

1. 返回到原先已經(jīng)發(fā)布到生產(chǎn)服務(wù)器上的分支。
2. 為這次緊急修補(bǔ)建立一個新分支，并在其中修復(fù)問題。
3. 通過測試后，回到生產(chǎn)服務(wù)器所在的分支，將修補(bǔ)分支合并進(jìn)來，然后再推送到生產(chǎn)服務(wù)器上。
4. 切換到之前實現(xiàn)新需求的分支，繼續(xù)工作。

分支的新建與切換

首先，我們假設(shè)你正在項目中愉快地工作，并且已經(jīng)提交了幾次更新（見圖 3-10）。

圖 3-10. 一個簡短的提交歷史

現(xiàn)在，你決定要修補(bǔ)問題追蹤系統(tǒng)上的 #53 問題。順帶說明下，Git 并不同任何特定的問題追蹤系統(tǒng)打交道。這里為了說明要解決的問題，才把新建的分支取名為 iss53。要新建并切換到該分支，運行 git checkout 并加上 -b 參數(shù)：

$ git checkout -b iss53
Switched to a new branch 'iss53'

這相當(dāng)于執(zhí)行下面這兩條命令：

$ git branch iss53
$ git checkout iss53

圖 3-11 示意該命令的執(zhí)行結(jié)果。

圖 3-11. 創(chuàng)建了一個新分支的指針

接著你開始嘗試修復(fù)問題，在提交了若干次更新后，iss53 分支的指針也會隨著向前推進(jìn)，因為它就是當(dāng)前分支（換句話說，當(dāng)前的 HEAD 指針正指向 iss53，見圖 3-12）：

$ vim index.html
$ git commit -a -m 'added a new footer [issue 53]'

圖 3-12. iss53 分支隨工作進(jìn)展向前推進(jìn)

現(xiàn)在你就接到了那個網(wǎng)站問題的緊急電話，需要馬上修補(bǔ)。有了 Git ，我們就不需要同時發(fā)布這個補(bǔ)丁和 iss53 里作出的修改，也不需要在創(chuàng)建和發(fā)布該補(bǔ)丁到服務(wù)器之前花費大力氣來復(fù)原這些修改。唯一需要的僅僅是切換回 master 分支。

不過在此之前，留心你的暫存區(qū)或者工作目錄里，那些還沒有提交的修改，它會和你即將檢出的分支產(chǎn)生沖突從而阻止 Git 為你切換分支。切換分支的時候最好保持一個清潔的工作區(qū)域。稍后會介紹幾個繞過這種問題的辦法（分別叫做 stashing 和 commit amending）。目前已經(jīng)提交了所有的修改，所以接下來可以正常轉(zhuǎn)換到 master 分支：

$ git checkout master
Switched to branch 'master'

此時工作目錄中的內(nèi)容和你在解決問題 #53 之前一模一樣，你可以集中精力進(jìn)行緊急修補(bǔ)。這一點值得牢記：Git 會把工作目錄的內(nèi)容恢復(fù)為檢出某分支時它所指向的那個提交對象的快照。它會自動添加、刪除和修改文件以確保目錄的內(nèi)容和你當(dāng)時提交時完全一樣。

接下來，你得進(jìn)行緊急修補(bǔ)。我們創(chuàng)建一個緊急修補(bǔ)分支 hotfix 來開展工作，直到搞定（見圖 3-13）：

$ git checkout -b hotfix
Switched to a new branch 'hotfix'
$ vim index.html
$ git commit -a -m 'fixed the broken email address'
[hotfix 3a0874c] fixed the broken email address
 1 files changed, 1 deletion(-)

圖 3-13. hotfix 分支是從 master 分支所在點分化出來的

有必要作些測試，確保修補(bǔ)是成功的，然后回到 master 分支并把它合并進(jìn)來，然后發(fā)布到生產(chǎn)服務(wù)器。用 git merge 命令來進(jìn)行合并：

$ git checkout master
$ git merge hotfix
Updating f42c576..3a0874c
Fast-forward
 README | 1 -
 1 file changed, 1 deletion(-)

請注意，合并時出現(xiàn)了“Fast forward”的提示。由于當(dāng)前 master 分支所在的提交對象是要并入的 hotfix 分支的直接上游，Git 只需把 master 分支指針直接右移。換句話說，如果順著一個分支走下去可以到達(dá)另一個分支的話，那么 Git 在合并兩者時，只會簡單地把指針右移，因為這種單線的歷史分支不存在任何需要解決的分歧，所以這種合并過程可以稱為快進(jìn)（Fast forward）。

現(xiàn)在最新的修改已經(jīng)在當(dāng)前 master 分支所指向的提交對象中了，可以部署到生產(chǎn)服務(wù)器上去了（見圖 3-14）。

圖 3-14. 合并之后，master 分支和 hotfix 分支指向同一位置。

在那個超級重要的修補(bǔ)發(fā)布以后，你想要回到被打擾之前的工作。由于當(dāng)前 hotfix 分支和 master 都指向相同的提交對象，所以 hotfix 已經(jīng)完成了歷史使命，可以刪掉了。使用 git branch 的 -d 選項執(zhí)行刪除操作：

$ git branch -d hotfix
Deleted branch hotfix (was 3a0874c).

現(xiàn)在回到之前未完成的 #53 問題修復(fù)分支上繼續(xù)工作（圖 3-15）：

$ git checkout iss53
Switched to branch 'iss53'
$ vim index.html
$ git commit -a -m 'finished the new footer [issue 53]'
[iss53 ad82d7a] finished the new footer [issue 53]
 1 file changed, 1 insertion(+)

圖 3-15. iss53 分支可以不受影響繼續(xù)推進(jìn)。

值得注意的是之前 hotfix 分支的修改內(nèi)容尚未包含到 iss53 中來。如果需要納入此次修補(bǔ)，可以用 git merge master 把 master 分支合并到 iss53；或者等 iss53 完成之后，再將 iss53 分支中的更新并入 master。

分支的合并

在問題 #53 相關(guān)的工作完成之后，可以合并回 master 分支。實際操作同前面合并 hotfix 分支差不多，只需回到 master 分支，運行 git merge 命令指定要合并進(jìn)來的分支：

$ git checkout master
$ git merge iss53
Auto-merging README
Merge made by the 'recursive' strategy.
 README | 1 +
 1 file changed, 1 insertion(+)

請注意，這次合并操作的底層實現(xiàn)，并不同于之前 hotfix 的并入方式。因為這次你的開發(fā)歷史是從更早的地方開始分叉的。由于當(dāng)前 master 分支所指向的提交對象（C4）并不是 iss53 分支的直接祖先，Git 不得不進(jìn)行一些額外處理。就此例而言，Git 會用兩個分支的末端（C4 和 C5）以及它們的共同祖先（C2）進(jìn)行一次簡單的三方合并計算。圖 3-16 用紅框標(biāo)出了 Git 用于合并的三個提交對象：

圖 3-16. Git 為分支合并自動識別出最佳的同源合并點。

這次，Git 沒有簡單地把分支指針右移，而是對三方合并后的結(jié)果重新做一個新的快照，并自動創(chuàng)建一個指向它的提交對象（C6）（見圖 3-17）。這個提交對象比較特殊，它有兩個祖先（C4 和 C5）。

值得一提的是 Git 可以自己裁決哪個共同祖先才是最佳合并基礎(chǔ)；這和 CVS 或 Subversion（1.5 以后的版本）不同，它們需要開發(fā)者手工指定合并基礎(chǔ)。所以此特性讓 Git 的合并操作比其他系統(tǒng)都要簡單不少。

圖 3-17. Git 自動創(chuàng)建了一個包含了合并結(jié)果的提交對象。

既然之前的工作成果已經(jīng)合并到 master 了，那么 iss53 也就沒用了。你可以就此刪除它，并在問題追蹤系統(tǒng)里關(guān)閉該問題。

$ git branch -d iss53

遇到?jīng)_突時的分支合并

有時候合并操作并不會如此順利。如果在不同的分支中都修改了同一個文件的同一部分，Git 就無法干凈地把兩者合到一起（譯注：邏輯上說，這種問題只能由人來裁決。）。如果你在解決問題 #53 的過程中修改了 hotfix 中修改的部分，將得到類似下面的結(jié)果：

$ git merge iss53
Auto-merging index.html
CONFLICT (content): Merge conflict in index.html
Automatic merge failed; fix conflicts and then commit the result.

Git 作了合并，但沒有提交，它會停下來等你解決沖突。要看看哪些文件在合并時發(fā)生沖突，可以用 git status 查閱：

$ git status
On branch master
You have unmerged paths.
  (fix conflicts and run "git commit")

Unmerged paths:
  (use "git add <file>..." to mark resolution)

        both modified:      index.html

no changes added to commit (use "git add" and/or "git commit -a")

任何包含未解決沖突的文件都會以未合并（unmerged）的狀態(tài)列出。Git 會在有沖突的文件里加入標(biāo)準(zhǔn)的沖突解決標(biāo)記，可以通過它們來手工定位并解決這些沖突?？梢钥吹酱宋募愃葡旅孢@樣的部分：

<<<<<<< HEAD
<div id="footer">contact : email.support@github.com</div>
=======
<div id="footer">
  please contact us at support@github.com
</div>
>>>>>>> iss53

可以看到 ======= 隔開的上半部分，是 HEAD（即 master 分支，在運行 merge 命令時所切換到的分支）中的內(nèi)容，下半部分是在 iss53 分支中的內(nèi)容。解決沖突的辦法無非是二者選其一或者由你親自整合到一起。比如你可以通過把這段內(nèi)容替換為下面這樣來解決：

<div id="footer">
please contact us at email.support@github.com
</div>

這個解決方案各采納了兩個分支中的一部分內(nèi)容，而且我還刪除了 <<<<<<<，======= 和 >>>>>>> 這些行。在解決了所有文件里的所有沖突后，運行 git add 將把它們標(biāo)記為已解決狀態(tài)（譯注：實際上就是來一次快照保存到暫存區(qū)域。）。因為一旦暫存，就表示沖突已經(jīng)解決。如果你想用一個有圖形界面的工具來解決這些問題，不妨運行 git mergetool，它會調(diào)用一個可視化的合并工具并引導(dǎo)你解決所有沖突：

$ git mergetool

This message is displayed because 'merge.tool' is not configured.
See 'git mergetool --tool-help' or 'git help config' for more details.
'git mergetool' will now attempt to use one of the following tools:
opendiff kdiff3 tkdiff xxdiff meld tortoisemerge gvimdiff diffuse diffmerge ecmerge p4merge araxis bc3 codecompare vimdiff emerge
Merging:
index.html

Normal merge conflict for 'index.html':
  {local}: modified file
  {remote}: modified file
Hit return to start merge resolution tool (opendiff):

如果不想用默認(rèn)的合并工具（Git 為我默認(rèn)選擇了 opendiff，因為我在 Mac 上運行了該命令），你可以在上方"merge tool candidates"里找到可用的合并工具列表，輸入你想用的工具名。我們將在第七章討論怎樣改變環(huán)境中的默認(rèn)值。

退出合并工具以后，Git 會詢問你合并是否成功。如果回答是，它會為你把相關(guān)文件暫存起來，以表明狀態(tài)為已解決。

再運行一次 git status 來確認(rèn)所有沖突都已解決：

$ git status
On branch master
Changes to be committed:
  (use "git reset HEAD <file>..." to unstage)

        modified:   index.html

如果覺得滿意了，并且確認(rèn)所有沖突都已解決，也就是進(jìn)入了暫存區(qū)，就可以用 git commit 來完成這次合并提交。提交的記錄差不多是這樣：

Merge branch 'iss53'

Conflicts:
  index.html
#
# It looks like you may be committing a merge.
# If this is not correct, please remove the file
#       .git/MERGE_HEAD
# and try again.
#

如果想給將來看這次合并的人一些方便，可以修改該信息，提供更多合并細(xì)節(jié)。比如你都作了哪些改動，以及這么做的原因。有時候裁決沖突的理由并不直接或明顯，有必要略加注解。