版權聲明：轉載時請以超鏈接形式標明文章原始出處和作者信息及本聲明
http://egeho123.blogbus.com/logs/18119163.html

Subversion快速指南

Subversion（簡寫為SVN）作為開源社區貢獻的新一代版本控制系統，已經得到越來越廣泛的使用。我用過CVS（Concurent Version System，SVN的前身）和微軟的VSS（Visual SourceSafe），相比之下，SVN具有更強大的功能和更簡單的操作特性。

網上已有一些文章介紹SVN的安裝和使用，不過我在第一次配置時仍然遇到了幾個問題。這里，我按照自己的思路來進行講解，以期對那些初次使用SVN并且對一些問題存在疑問的朋友有所幫助。

1. SVN簡介

光說SVN好，那SVN究竟有什么優點呢？在SVN的手冊里有著詳細的說明，下面簡單介紹幾個重要方面：

1) 基于目錄的版本控制

傳統的CVS或VSS都是基于單個文件進行版本控制的，這實際上滿足不了實際需求，因為在實際應用中，我們都希望按照項目或者工程進行管理，例如假設我們想要取出某個歷史時間點的整個項目文件，那么基于文件的版本控制系統就存在弊端，只能單個單個文件的處理。而SVN則能很方便的做到這一點，你可以隨意的取出任何一個文件、任何一個目錄的任何一個歷史版本。

SVN還允許對文件和目錄進行增加、刪除以及復制和重命名等操作，這些都會被記錄到歷史信息中，實現真正的版本控制功能。

2) 原子提交

SVN里的每次操作都是原子的，要么全部成功，要么全部失敗。假設你要提交多個文件，如果有一個存在沖突，那么其它修改都不會被提交。

3) 高效的分支（branching）與標簽（tagging）功能

先說標簽功能，通俗的講，標簽就是某個時間點的快照（snapshot），我們可以在項目進行到一些重要的里程碑之時為之建立標簽，這樣可以方便以后隨時取出這些歷史版本。我想你會有一個疑問：SVN不是本身就有隨意取出任何一個歷史版本的功能嗎？是的，標簽的作用主要是為了給這些特定的歷史版本取一個友好的名字，以方便使用和維護。

分支則是用于創建多個并行的工作線，比如，當我們的一個項目需要為某個用戶提供一些特殊的功能時，那么就可以為之創建一個分支，這樣能夠保正大部分代碼的共用，也使得整個項目變得容易維護和管理。

SVN對于分支和標簽的實現都是一樣的，并且采用了與Unix/Linux硬鏈接（Hard-Link）類似的機制，即是說，當我們創建分支或標簽時，SVN并不會立即為之創建一份拷貝，而是創建一個鏈接，只有當這些文件以后被修改時才會真正產生一份副本。這種“緩式拷貝”方法是一種常見的優化方法，能夠有效的節約空間。

那分支和標簽又有什么不同呢？不同之處僅僅在于其“約定成俗”的含義，標簽意味著你不會再對其進行修改，而分支意味著你會對它進行開發。

4) 多種訪問方式

SVN提供了一個抽象的網絡訪問層，可以通過不同的協議來對其進行訪問。首先，SVN提供了自定義的svn協議訪問方式，通過形如svn://host/repository的URL就能使用。再有，SVN還提供了與Apache Web服務器相集成的功能，這樣，我們就可以通過http://host/repository的方式來訪問SVN了。

5) 對二進制文件的支持

CVS雖然對二進制文件也有支持，但實現得并不完善，你或許遇到過文本文件里有中文字符而被認為是二進制文件的事情，SVN則提供了對二進制文件全面的支持，使得非文本文件也能跟文本文件一樣進行良好的版本控制。

6) Windows下與資源管理器集成的客戶端：TortoiseSVN

SVN本身只提供命令行的操作方式，TortoiseSVN是第三方開發的圖形化界面，它的出現使Windows下的版本管理變得非常方便。不過，由于是嵌入到資源管理器中，它可能會影響系統的速度——微乎其微，你可以自己評測一下。

7) 平臺無關

SVN秉承了開源軟件的一貫優點，無論是Windows還是Linux平臺，都可以相互訪問SVN服務器。

如果你過去是VSS用戶，那么這里還要提一點，與VSS相比，SVN還有一個理念不一樣，VSS將版本沖突控制放在操作之前，你要操作某個項目必須先執行CheckOut以進行鎖定、防止他人同時修改。SVN提供了同樣的Lock功能，但通常情況下，我們只需各自獨立的進行修改而無需鎖定項目，如果有沖突在提交的時候再做處理，也就是說，SVN是將沖突控制放在操作之后、提交之時。也許你會覺得VSS更合理，但實際情況卻相反，因為在我們的實際使用中經常發生有人將整個項目CheckOut后忘了CheckIn，或者未選擇Recursive忘了將子目錄中的文件CheckIn，這就讓其他人無法修改，于是不得不人為的通知其本人，非常麻煩。

2. SVN服務器搭建

本節是針對管理員寫的，普通用戶可以跳過本節。我這里只以Windows上的安裝為例，Linux上可按類似方式進行（有些配置參數會存在差別，具體參考幫助手冊）。

1) 安裝SVN服務器

a. 下載

SVN的官方網站為http://subversion.tigris.org/，當前最新版本為1.4.2。Windows下的二進制安裝包分為兩種，一種是以setup結尾的安裝文件，另一種是普通的壓縮包文件，setup文件會自動注冊一些信息，比如環境變量以及服務等，這些都是可以自己手動實現的。在我寫這篇文章時，官方網站上就只有普通二進制文件，估計setup文件稍晚些時候會出來。特別注意，下載時要詳細閱讀注意事項，看清與之配套的軟件的版本號，避免出現問題。

我選擇的版本為svn-win32-1.4.2.zip

b. 安裝

將svn-win32-1.4.2.zip解壓縮到安裝目錄下，我選擇的是C:/Program Files/Subversion，如果是setup文件，直接運行安裝文件即可。對于壓縮包，我們可以將bin路徑添加到系統環境變量中，以方便操作。可以看到，bin目錄下主要有如下幾個文件：

svnadmin：倉庫管理工具，包括創建、修復和備份等操作。
svnlook：倉庫查看工具，包括信息、日志和鎖定狀態等內容，不會造成倉庫的改動。
svnserve：svn服務程序，允許通過svn網絡協議來訪問倉庫。
svn：SVN客戶端，用于訪問倉庫，對項目進行版本管理。
svnversion：客戶端工具，用于查看本地拷貝的修訂信息。
c. 創建倉庫（Repository）

SVN是以倉庫為版本控制單位的，一個SVN服務器可以管理多個倉庫，每個倉庫擁有獨立的修訂號（REVISION），倉庫中的任何一次更新都會帶來修訂號的遞增。你可以根據需要選擇建立一個或者多個倉庫，這里，我以創建多個倉庫為例子，假設我們將倉庫都放到D:/SVN_REPOS目錄下，下面的命令將會在該目錄下創建一個Test倉庫：

svnadmin create D:/SVN_REPOS/Test
如果創建成功，D:/SVN_REPOS/下將會多一個Test目錄。
2) 搭建svnserve訪問方式

svn和http是兩種并列的訪問方式，你可以選擇其中一種，也可以都采用。

a. 注冊服務

為了讓SVN服務程序每次開機后自動運行，我們需要將其注冊為服務。在控制臺中執行如下命令：

sc create svnservice binPath= "\"C:\Program Files\Subversion\bin\svnserve.exe\" --service -r D:/SVN_REPOS" start= auto
注意，上述命令均在一行中。sc.exe是Windows 2000以后系統自帶的一個工具，2000下沒有，可以從XP上拷過來。svnservice為服務名稱，后面的參數格式有嚴格要求，等號前面沒有空格而后面有。binPath本身帶有多個參數，因此用引號括起來，而由于路徑里面又有空格，因此又加上了一層引號。 --service和-r均為svnserve.exe的參數，前者要求它作為服務運行，后者指明了倉庫的根路徑（多倉庫為倉庫的父目錄）。
帶安裝包的SVN會自動注冊服務，這時我們可能需要修改-r參數，命令如下：

sc config svnservice binPath= "\"C:\Program Files\Subversion\bin\svnserve.exe\" --service -r D:/SVN_REPOS"
b. 訪問

注冊完后，通過運行sc start svnservice或者服務管理器（service.msc）啟動服務。
接下來，我們就可以通過下面的命令來測試系統是否工作正常：

svn info svn://localhost/Test
如果正確的顯示出倉庫的相關信息，那么就大功告成了，否則請檢查服務的參數是否配置正確，比如，如果未在服務參數中指定正確的-r值，就會得到如下錯誤：

No repository found in 'svn://localhost/Test'
如果安裝了TortoiseSVN，則可以直接在瀏覽器中輸入svn://localhost/Test，這樣會調出TortoiseSVN的Repos-Browser。到此，你就可以通過TortoiseSVN來導入工程進行版本管理了（參見后文）。

c. 權限配置

在進行權限配置前，所有的用戶都能進行任何操作，在很多情況下是不允許的。在創建倉庫時，倉庫目錄下都會生成好幾個文件夾，其中conf里面存儲的是配置信息，包括三個文件：

authz：訪問權限配置
passwd：用戶名和密碼配置
svnserve.conf：基本配置信息
先配置svnserve.conf，將里面幾項配置前的注釋去掉，最后的內容如下：

[general]
anon-access = read
auth-access = write
password-db = passwd
authz-db = authz
這些參數的含義文件里都有詳細說明，其中，anon-access和auth-access分別是對匿名用戶以及認證用戶的訪問控制，password-db指明用戶密碼文件路徑，authz-db指明權限配置文件路徑。另外還有一個參數realm用于指明倉庫所屬的認證域，默認情況下每個倉庫位于不同的域（每個倉庫有一個唯一的uuid），因此我們可以不設置該項，除非多個倉庫需要共用同一份passwd配置。

passwd文件的配置很簡單，格式如下（等號前面為用戶名，后面為密碼）：

[users]
harry = 123
sally = 123
guest = 123
authz則可以創建用戶組并精確配置某個用戶或用戶組對某個文件或目錄的訪問權限，下面是一個例子：

[groups]
harry_and_sally = harry,sally
 

[/]
* = r

[/project1]
* =
harry = rw
sally = r

[/project1/foo]
sally =

[/project2]
@harry_and_sally = rw
guest = r

文件內容其實很簡單易懂，groups用于定義用戶組，后面便是對資源的具體訪問控制，/表示倉庫根目錄，*表示所有用戶，用戶組前面需加上@符號，r表示可讀，w表示可寫，等號右邊為空則表示沒有權限。注意對于目錄結構，當用戶訪問某個資源時，SVN會先看有沒有直接針對該資源的訪問控制，如果沒有找到，則會繼承上一級目錄的訪問權限，如此遞推。

再提一點，當我們有多個倉庫時，我們會發現這些倉庫的用戶帳號在大多數情況下都是相同的，因此，我們可以將passwd文件放到公共的地方，然后將所有倉庫的password-db配置都指向該文件。相應的，authz-db也可以共用一個文件，不過需要在配置具體的訪問控制時指明所屬的倉庫，如下：

[/]
* = r
 

[repos1:/project1]
* = r
harry = rw

[repos2:/project1]
* = r
sally = rw

上述配置表明，所有人對所有倉庫的根目錄都有讀權限，但只有harry對倉庫repos1里的project1有讀寫權限，只有sally對倉庫repos2里的project1有讀寫權限。
3) 搭建HTTP訪問方式

SVN可以通過Apache實現Web訪問方式，但這不是必需的，除非你有此需求。

a) 下載

Apache的官方網站為http://www.apache.org/，注意不要使用最新的2.2.x，而要選擇2.0.x，這一點在SVN官方網站上有特別說明，當初我就沒有注意到這一點，而導致Apache2.2啟動時無法加載SVN的模塊，出現“perhaps this is not an Apache module DSO”錯誤。

我下載的版本為apache_2.0.59-win32-x86-no_ssl.msi

b) 安裝和注冊

執行Apache安裝程序。由于2.0的版本不會自動注冊為服務，因此我們需要手工處理。運行cmd.exe，進入apache安裝目錄下的bin文件夾，執行如下命令即可：

apache -k install
更多的命令可以通過apache help查看。

注冊完后，就可以通過系統托盤里的Apache Monitor來啟動服務。如果80端口未被占用，那么服務器應正常啟動，通過http://127.0.0.1就能看到Apache的測試頁面。

c) 配置

Apache是通過conf目錄中的httpd.conf文件進行配置的，比如，默認的監聽端口為80，在文件中搜索Listen 80，將80改成你所需的其它端口即可。配置完后必須重起Apache才能生效。更多關于Apache的配置說明請參見其幫助手冊或google之。下面網站為幫助手冊的中文版本。

為了讓Apache支持SVN，比如增加一些配置項，一個典型的配置如下：

# 加載mod_dav模塊，它是對WebDAV（Web-based Distributed Authoring and Versioning）協議的支持，由Apache自帶
LoadModule dav_module modules/mod_dav.so

# 加載mod_dav_svn模塊，它與mod_dav通信，使Apache支持SVN，它位于SVN的bin目錄下。
LoadModule dav_svn_module "D:/Program Files/Subversion/bin/mod_dav_svn.so"

# 加載mod_authz_svn模塊，用于進行權限管理
LoadModule authz_svn_module "D:/Program Files/Subversion/bin/mod_authz_svn.so"

# 配置SVN的訪問路徑以及相關相關參數
<Location /svn/>                             # 通過http://HOST/svn/訪問SVN服務器
    DAV svn                                  # 必需
    SVNParentPath D:/SVN_REPOS               # 說明D:/SVN_REPOS下的所有目錄均為倉庫
    SVNListParentPath on                     # 在網頁中列出D:/SVN_REPOS下的所有倉庫
   
    AuthType Basic                           # 基本的用戶名密碼驗證方式
    AuthName "SVN REPOS"                     # 認證名稱，作提示用
    AuthUserFile D:/SVN_REPOS/users          # 用戶名密碼文件
    AuthzSVNAccessFile D:/SVN_REPOS/authz    # 權限控制文件

    Require valid-user                       # 只有通過認證才能訪問網頁
</Location>

# 重定向處理，用于將http://HOST/svn地址重定向為http://HOST/svn/
RedirectMatch ^(/svn)＄ ＄1/

下面對幾個重要的地方作以說明：

i. 網上很多文章提到將mod_dav_svn.so和mod_authz_svn.so兩個文件直接拷貝到Apache的modules目錄下，當初我按照這種方法做時結果在一臺Windows 2000 Server上無法啟動Apache服務，為此折騰了半天。后來才明白，這些模塊文件其實就是一些動態鏈接庫，它需要依賴SVN的bin目錄下的其它幾個dll文件（可以把后綴改為dll，然后通過VC帶的depends查看其依賴關系），因此如果沒有設置環境變量，那么Apache加載這些模塊時就會失敗，當然也可以把所有依賴文件（主要是libdb43.dll ）拷貝過去。實際上，我們只需要通過絕對路徑來引用這些模塊即可，這樣SVN升級后也不用再次拷貝。

ii. URL的訪問路徑為/svn/而不是/svn，因為后者可能有問題，導致通過http://HOST/svn訪問出現如下錯誤信息

iii. SVNParentPath用于有多個倉庫的情況，如果只有單個倉庫，可以直接用SVNPath指明倉庫路徑。

iv. AuthUserFile指明用戶名密碼文件，但它與前面提到的SVN倉庫下的passwd文件不是同一個文件，AuthUserFile是Apache的認證文件格式，二者的區別主要是用戶名和密碼的分割符不同，passwd是等號，這里的users是冒號，當初我就是把它們當成一個文件而造成客戶端無法訪問（為什么SVN不把passwd的格式定義成和AuthUserFile的一樣呢？這樣二者可以共用一個文件）。如果要對密碼加密，那么users文件需通過Apache附帶的htpasswd工具生成，實際上我們也可直接采用明文方式。

v. 權限控制文件AuthzSVNAccessFile與前面SVN里的authz一樣，因此可以共用。

4) 其它管理功能

a. 備份

b. 修復

3. SVN客戶端使用

本節針對客戶端用戶，主要介紹一些常用的操作方法。

1) 客戶端安裝

客戶端可以采用命令行方式，也可以采用TortoiseSVN圖形化方式，個人認為還是后者方便些。

TortoiseSVN從http://tortoisesvn.tigris.org/上獲取，注意版本應與服務器保持一致。如果是命令行方式的話，那么從http://subversion.tigris.org/下載一個SVN二進制包就行了，此處不多講。

TortoiseSVN屬于圖形化的客戶端軟件，其實前面的SVN安裝包里已經含有客戶端程序，只不過是命令行方式的，你可以根據需要選擇是否安裝。TortoiseSVN的官方網站為http://tortoisesvn.tigris.org/，同樣，注意選擇與SVN服務器配套的版本。

我這里使用的版本為TortoiseSVN-1.4.0.7501-win32-svn-1.4.0.msi

安裝完后，會提示重起機器，實際上不用重起就能直接使用，只不過重起后會更新SVN文件圖標的顯示。下圖是SVN工作區的右鍵菜單內容：

2) 主要操作

TortoiseSVN使用起來很簡單，所有操作都通過右鍵菜單來完成。命令內容也很直觀，而且有非常詳細的幫助手冊，這里只簡單的介紹一下。

a) 導入項目（Import）

首先要把需要進行版本管理的工程（目錄）整理好，去掉不必要的文件，比如編譯器生成的臨時文件。然后在最上層文件夾上單擊右鍵，選擇“TortoiseSVN -> Import...”，輸入要存放的SVN服務器路徑，確認即可。這樣就將本地的項目導入到了服務器上。

命令行：svn import [PATH] URL

b) 檢出項目（Checkout）

項目初次導入成功后，剛才本地的內容就沒有用了，我們需要建立一個新的工作區，重新從SVN服務器下載受控的項目文件，執行“TortoiseSVN -> Checkout...”，選擇或者輸入項目的URL，確認即可，以后的工作都應在這個工作區里進行。

默認是獲取項目的最新版本（HEAD），如果要獲取歷史版本，指定相應的修訂號（Revision）即可。

命令行：svn checkout URL[@REV]... [PATH]

c) 更新與提交（Update and Commit）

他人修改了項目，我們需要從服務器下載最新版本，這通過“SVN Update”右鍵菜單實現。

命令行：svn update [PATH...]

如果是自己本地作了修改，則應及時將修改更新到服務器上去，這通過“SVN Commit...”實現。一個好的習慣是每次提交都應注明修改內容，以方便日后查證。

命令行：svn commit [PATH...]

d) 增加和刪除文件（Add and Delete）

如果我們要向一個受控項目中添加新文件或文件夾，只需在目標上執行“TortoiseSVN -> Add”操作。注意，這里只是本地添加，要提交到服務器，還必須執行Commit才行。

命令行：svn add PATH...

同樣，要刪除受控文件或文件夾只需執行“TortoiseSVN -> Delete”操作。

命令行：svn delete PATH/URL...

TortoiseSVN還提供了一個重命名操作“TortoiseSVN -> Rename”，這其實是添加和刪除的組合。

e) 撤銷操作（Revert）

有時候，我們可能進行了錯誤的修改或者增加和刪除，只要未進行提交，我們都可以通過“TortoiseSVN -> Revert”命令來撤銷本地的所有更改。

命令行：svn revert PATH...

f) 查看信息

SVN提供了幾種信息查看方式，其中Show log用于顯示每次版本變更的日志信息，Repo-brower是倉庫瀏覽器，類似于資源管理器，Revision graph則以圖形化的方式讓我們很直觀的看到版本的變更情況，尤其是對于分支和標簽管理很有幫助。

3) 其它操作

a) 沖突解決（Resolved）

如果我們本地進行了修改，而別人又把他的修改提交到了服務器上，這時我們執行Update就可能出現沖突（Conflict）。Resolved的作用不是解決沖突，它不進行任何合并，而是忽略掉他人的修改，允許我們將自己的版本提交到服務器上。

簡單的說，Revent是撤銷本地修改，而Resolved是保留本地修改。

b) 清除異常狀態（Cleanup）

如果在執行某個命令的時候出現異常，比如服務器突然掛了，本地的工作區就會處于一種異常狀態，通過Cleanup能夠清除這種狀態，使工作區不受到影響。

c) 鎖定（Get lock）和解鎖（Release lock）

沖突都是由于不同的開發人員同時修改了同一份文件造成的，因此，為了避免這種情況，我們可以強行鎖定自己要修改的內容，這樣其他人在我們解鎖前就無法提交其修改。

d) 分支和標簽（Branch/tag）

本文最開始就有說明，分支的目的是為了創建并行的工作線，標簽的作用是為了保存項目某個版本的快照。二者在實現上卻是一樣的，都是通過Branch/tag命令執行。

e) 導出（Export）

為了實現版本管理，SVN會在工作區的每個目錄下都生成一個隱藏的.svn文件夾，而我們有時卻希望得到一個干凈的沒有.svn文件夾的項目結構，比如發布軟件時，這種情況下就可以使用Export功能。

f) 重定向（Relocate）

有時候，SVN服務器的IP地址可能會發生變動，如果遇到這種情況，我們每個人的本地工作區都要重新下載嗎？不用，只需通過Relocate重新配置一下本地工作區所對應的服務器地址就可以。

g) 補丁管理（patch）

不要被patch的名稱迷惑，實際上它不屬于SVN版本管理的范疇。這里所謂的patch是指那些對項目沒有寫權限（Commit）的人所作的修改，通過“TortoiseSVN -> Create Patch”生成，然后他們采用電子郵件等方式將patch發給項目管理員，由管理員執行“TortoiseSVN -> Apply Patch”并確認修改內容后再進行提交。該功能主要用于開源項目的管理。