svn branch and merge（svn切換分支和合并）詳解 - langtianya－IT工程師數位筆記本

文章出處

下文的實踐主要是參考了TortoiseSVN的幫助文檔和Subversion的在線文檔，Subversion的在線文檔：http://svnbook.red-bean.com/en/1.5/svn-book.html

先說說什么是branch。按照Subversion的說法，一個branch是某個development line（通常是主線也即trunk）的一個拷貝，見下圖：

branch存在的意義在于，在不干擾trunk的情況下，和trunk并行開發，待開發結束后合并回trunk中，在branch和trunk各自開發的過程中，他們都可以不斷地提交自己的修改，從而使得每次修改在repository中都有記錄。

設想以下場景，如果你的項目需要開發一個新功能，而該功能可能會修改項目中的絕大多數文件，而與此同時，你的另一位同事正在進行bug fix，如果你的新功能不在branch中開發而直接在trunk中開發，那么你極有可能影響另一位同事的bug fix，他/她在bug修復中可能會遇到各種各樣的問題，因為你的頻繁提交代碼引入了過多的不穩定因素。你可能會說，那我在開發的過程中不提交不就行了，等到我全部開發結束我再提交，是，你可以這么做，那還要版本控制干什么呢？也許等到你最后提交代碼的時候（也許一周，也許兩周？），你會發現有一大堆conflict等著你resolve。。。

那么，正確的做法是什么？使用branch，從trunk創建branch，然后在你的branch上開發，開發完成后再合并到trunk中。

關于branch先講到這里，下面說說什么叫做合并。很好理解，當branch開發完成后（包括必要的測試），將branch中的修改同步到trunk中，這個過程有可能包括修改文件、增加文件、刪除文件等等。

說到這里，貌似本文差不多可以結束了，不就是分支和合并么？只要再簡單地說說如何建立分支和如何合并就可以收尾了，可能只需兩個命令，也可能只需鼠標點幾下然后鍵盤敲兩下即可。其實事情遠非這么簡單，愛動腦筋的同學可能會問了，將branch的改動merge到trunk的時候，和上文說的直接在trunk中全部開發完然后提交有何區別？你最后還不是要處理一大堆conflict？

這個問題問得非常好，其實這正是本文的重點：branch和trunk在并行開發的過程中如何感知對方，branch如何才能在開發過程中不會和trunk越走越遠，導致最后無法合并？試想一下，如果在你開發branch的過程中，trunk中的某個類文件已經被刪除了（這可能是另外一個家伙在另一個branch上開發了兩周后才合并到trunk的），而你竟然在這個類文件上做了大量修改，試問你到最后合并回trunk的時候該有多蛋疼？解決這一問題的唯一手段是，branch要不停地和trunk保持同步，你要及時地知道trunk都做了什么修改，這些修改是否會影響你正在開發的新功能，如果需要，你必須及時調整branch的代碼，使之能與trunk“兼容”。

那么如何讓branch和trunk保持同步？合并，從trunk合并到branch，你沒聽錯，是從trunk合并到branch。關于TortoiseSVN的合并，有幾點需要注意：

TortoiseSVN的合并發生在本地，也即你的working copy中，你無需過多擔心會對repository中的代碼造成影響

不管是從trunk合并到branch還是最終從branch合并回trunk，在每次合并前最好先update，然后將本地的修改先全部commit，保護好現場，萬一合并不理想隨時都可以revert
合并完成后看是否能正確編譯，然后測試驗證，最后將合并后的改動提交到repository

下面我將step by step地演示如何一次完整的branching和merging，包括創建分支、分支開發、分支和主線同步，分支合并到主線的全過程，甚至包括如何在本地創建一個測試用的repository。

首先需要安裝TortoiseSVN，我安裝的版本是：TortoiseSVN 1.6.15, Build 21041 - 32 Bit , 2011/03/23 18:00:27

1、本地Repository的創建

repository的創建很簡單，假設我要在D:\TortoiseSVN\TestRepository目錄中創建repository，只需右鍵TestRepository目錄，依次選擇"TortoiseSVN" -> "Create repository here"便完成了repository的創建。

2、Check out

假設要check out到D:\TortoiseSVN\TestSVN，同樣很簡單，在D:\TortoiseSVN目錄下創建TestSVN目錄，然后在該目錄上右鍵，選擇"SVN Check out..."，在彈出的窗口中的"URL of repository"中填入"file:///D:/TortoiseSVN/TestRepository"，其他默認即可，最后點擊ok。

3、trunk創建新項目MyProject

相當簡單就不贅述了，只列出本次操作所作出的修改：

4、創建branch

在/trunk/MyProject目錄上右鍵，依次選擇"TortoiseSVN" -> "Branch/tag..."，在彈出窗口的"To URL"中填入分支的地址，在這里目標revision選擇HEAD revision，如下圖所示，添加log后點擊ok分支便建立了。這個操作速度非常快，新建的branch在repository中其實只是一個指向trunk某個revision的軟連接而已，并沒有真的復制文件。

5、Check out分支

右鍵TestSVN目錄選擇"TortoiseSVN Update"即可將剛剛建立的分支下載回本地。進入/branches/MyProject目錄下你會發現其文件結構和/trunk/MyProject一模一樣。

6、branch提交一個新文件

7、trunk緊接著提交一個修改

8、branch再次提交一個修改

9、將trunk中的修改同步到branch

6-8演示的是branch和trunk在獨立、并行地開發。為了防止在“錯誤”的道路上越走越遠，現在branch意識到是時候和trunk來一次同步了（將trunk合并到branch）。

首先，在本地trunk中先update一下，有沖突的解決沖突，保證trunk和repository已經完全同步，然后在/branches/MyProject上右鍵，依次選擇"TortoiseSVN" -> “Merge...”，在彈出的窗口中選擇第一項"Merge a range of revision"，這個類型的Merge已經介紹得很清楚，適用于將某個分支或主線上提交的多個revision間的變化合并到另外一個分支上。

點擊next后，出現如下窗口：

由于是要從trunk合并到branch，理所當然這里的"URL to merge from"應該填trunk的路徑，"Revision range to merge"很好理解，就是你要將trunk的哪些revision所對應的變化合并到branch中，可以是某一連串的revision，比如4-7，15-HEAD，也可以是某個單獨的revision號。由于在r4中，trunk修改了Person.java中的talk()方法，所以這里的revision只需填4即可。點擊next后出現下圖：

在這里只需保留默認設置即可。在點擊Merge按鈕前你可以先Test merge一把，看成功與否，以及merge的詳細信息。點擊Merge按鈕后trunk所做的修改將同步到branch中。

10、提交合并后的branch

至此，branch已經完全和trunk同步，branch和trunk的代碼相處很融洽，沒有任何沖突，如果branch已經開發結束，那是時候將branch合并回trunk了，當然，如果branch還要繼續開發，那你將不斷地重復6-10這幾個步驟。

11、將branch合并回trunk

在/trunk/MyProject上右鍵（注意是在主線的目錄上右鍵），依次選擇"TortoiseSVN" -> "Merge..."，在彈出的窗口中，Merge type選擇第二項"Reintegrate a branch"，這種類型的合并適合在分支開發結束后將所有的改動合并回主線。

點擊next后出現如下窗口：

在這里，"From URL"選擇/branches/MyProject，無需選擇revision號，Reintegrate會將branch上所有修改合并到trunk。后面的步驟和上文第9步中的一樣，不再啰嗦了。如無意外，branch將成功合并到trunk，你需要做的只是將合并后的trunk趕緊commit！

12、提交合并后的trunk

so easy...

13、刪除branch

如果你認為你新加的功能已經開發完成了，你可以刪除你的分支

到這里，我已經給你演示完了整個過程，我一身的汗也下來了，我想罷工了，不過最后我們還是看看所有的log信息吧，通過log能發現我們干的所有事情：