SVN的全稱是Subversion，即版本控制系統。它是最流行的一個開放原始碼的版本控制系統。作為一個開源的版本控制系統，Subversion管理著隨時間改變的資料。這些資料放置在一箇中央資料檔案庫（Repository）中。這個檔案庫很像一個普通的檔案伺服器，不過它會記住每一次檔案的變動。這樣就可以把檔案恢復到舊的版本，或是瀏覽檔案的變動歷史。Subversion是一個通用的系統，可用來管理任何型別的檔案，其中包括程式原始碼。

SVN採用客戶端/伺服器體系，專案的各種版本都儲存在伺服器上，程式開發人員首先將從伺服器上獲得一份專案的最新版本，並將其複製到本機，然後在此基礎上，每個開發人員可以在自己的客戶端進行獨立的開發工作，並且可以隨時將新程式碼提交給伺服器。當然也可以通過更新操作獲取伺服器上的最新程式碼，從而保持與其他開發者所使用版本的一致性。

SVN的客戶端有兩類，一類是基於Web的WebSVN等，另一類是以Tortoise SVN為代表的客戶端軟體。前者需要Web伺服器的支援，後者需要使用者在本地安裝客戶端，兩種都有免費的開源軟體供使用。SVN儲存版本資料也兩種方式：BDB（一種事務安全型表型別）和FSFS（一種不需要資料庫的儲存系統）。因為BDB方式在伺服器中斷時，有可能鎖住資料，所以還是FSFS方式更安全一點。

svn基本的操作流程就是：

　　你剛剛進入一個新的公司，讓你接手一個正在進行的專案，你開啟終端寫下了：

svn co svn://192.168.1.1/pro/domain

然後就可以在當前目錄裡面找到一個叫domain的專案，cd domain，你瀏覽了幾行程式碼，太特麼的竟然有bug，你忍不住改了，你要提交了

svn ci -m 'something'

成功。你又在domain下得app資料夾下添加了幾個.php檔案，把整個專案都做完了！你又開啟終端：

svn add domain/app/*.php

新增成功。太牛逼了，下班了，你去吃了一碗自己最喜歡的老壇酸菜味方便麵。

以下是一些常用命令

1、將檔案checkout到本地目錄

svn checkout path（path是伺服器上的目錄）
例如：svn checkout svn://192.168.1.1/pro/domain
簡寫：svn co

2、往版本庫中新增新的檔案

svn add file
例如：svn add test.php(新增test.php)

svn add *.php(添加當前目錄下所有的php檔案)

3、將改動的檔案提交到版本庫

svn commit -m “LogMessage“ [-N] [--no-unlock] PATH(如果選擇了保持鎖，就使用–no-unlock開關)
例如：svn commit -m “add test file for my test“ test.php
簡寫：svn ci

4、加鎖/解鎖

svn lock -m “LockMessage“ [--force] PATH
例如：svn lock -m “lock test file“ test.php
svn unlock PATH

5、更新到某個版本

svn update -r m path
例如：
svn update如果後面沒有目錄，預設將當前目錄以及子目錄下的所有檔案都更新到最新版本。
svn update -r 200 test.php(將版本庫中的檔案test.php還原到版本200)
svn update test.php(更新，於版本庫同步。如果在提交的時候提示過期的話，是因為衝突，需要先update，修改檔案，然後清除svn resolved，最後再提交commit)

簡寫：svn up

6、檢視檔案或者目錄狀態

svn status path（目錄下的檔案和子目錄的狀態，正常狀態不顯示）
【?：不在svn的控制中；M：內容被修改；C：發生衝突；A：預定加入到版本庫；K：被鎖定】
svn status -v path(顯示檔案和子目錄狀態)
第一列保持相同，第二列顯示工作版本號，第三和第四列顯示最後一次修改的版本號和修改人。
注：svn status、svn diff和 svn revert這三條命令在沒有網路的情況下也可以執行的，原因是svn在本地的.svn中保留了本地版本的原始拷貝。
簡寫：svn st

7、刪除檔案

svn delete path -m “delete test fle“
例如：svn delete svn://192.168.1.1/pro/domain/test.php -m “delete test file”
或者直接svn delete test.php 然後再svn ci -m ‘delete test file‘，推薦使用這種
簡寫：svn (del,remove,rm)

8、檢視日誌

svn log path
例如：svn log test.php 顯示這個檔案的所有修改記錄，及其版本號的變化

9、檢視檔案詳細資訊

svn info path
例如：svn info test.php

10、比較差異

svn diff path(將修改的檔案與基礎版本比較)
例如：svn diff test.php
svn diff -r m:n path(對版本m和版本n比較差異)
例如：svn diff -r 200:20test.php
簡寫：svn di

11、將兩個版本之間的差異合併到當前檔案

svn merge -r m:n path
例如：svn merge -r 200:205 test.php（將版本200與205之間的差異合併到當前檔案，但是一般都會產生衝突，需要處理一下）

12、SVN 幫助

svn help
svn help ci

13、版本庫下的檔案和目錄列表

svn list path
顯示path目錄下的所有屬於版本庫的檔案和目錄
簡寫：svn ls

14、建立納入版本控制下的新目錄

svn mkdir: 建立納入版本控制下的新目錄。
用法:
1、mkdir PATH…
2、mkdir URL…
建立版本控制的目錄。
1、每一個以工作副本 PATH 指定的目錄，都會建立在本地端，並且加入新增
排程，以待下一次的提交。
2、每個以URL指定的目錄，都會透過立即提交於倉庫中建立。
在這兩個情況下，所有的中間目錄都必須事先存在

15、恢復本地修改

svn revert: 恢復原始未改變的工作副本檔案 (恢復大部份的本地修改)。revert:
用法: revert PATH…
注意: 本子命令不會存取網路，並且會解除衝突的狀況。但是它不會恢復
被刪除的目錄

16、程式碼庫URL變更

svn switch (sw): 更新工作副本至不同的URL。
用法: 1、switch URL [PATH]
2、switch –relocate FROM TO [PATH...]

1、更新你的工作副本，對映到一個新的URL，其行為跟“svn update”很像，也會將
伺服器上檔案與本地檔案合併。這是將工作副本對應到同一倉庫中某個分支或者標記的
方法。
2、改寫工作副本的URL元資料，以反映單純的URL上的改變。當倉庫的根URL變動
(比如方案名或是主機名稱變動)，但是工作副本仍舊對映到同一倉庫的同一目錄時使用
這個命令更新工作副本與倉庫的對應關係。

17、解決衝突

svn resolved: 移除工作副本的目錄或檔案的“衝突”狀態。
用法: resolved PATH…
注意: 本子命令不會依語法來解決衝突或是移除衝突標記；它只是移除衝突的
相關檔案，然後讓 PATH 可以再次提交

檢視修改的檔案記錄

svn cat -- 顯示特定版本的某檔案內容。
svn list -- 顯示一個目錄或某一版本存在的檔案列表。
svn log -- 顯示svn 的版本log，含作者、日期、路徑等。
svn diff -- 顯示特定修改的行級詳細資訊。

list示例：

svn list http://svn.test.com/svn #檢視目錄中的檔案。
svn list -v http://svn.test.com/svn #檢視詳細的目錄的資訊(修訂人,版本號,檔案大小等)。
svn list [-v] #檢視當前當前工作拷貝的版本庫URL。

cat示例：

svn cat -r 4 test.c #檢視版本4中的檔案test.c的內容,不進行比較。

diff示例：

svn diff #什麼都不加，會堅持原生代碼和快取在本地.svn目錄下的資訊的不同;資訊太多，沒啥用處。
svn diff -r 3 #比較你的原生代碼和版本號為3的所有檔案的不同。
svn diff -r 3 text.c #比較你的原生代碼和版本號為3的text.c檔案的不同。
svn diff -r 5:6 #比較版本5和版本6之間所有檔案的不同。
svn diff -r 5:6 text.c #比較版本5和版本6之間的text.c檔案的變化。
svn diff -c 6 test.c #比較版本5和版本6之間的text.c檔案的變化。

log示例：

svn log #什麼都不加會顯示所有版本commit的日誌資訊:版本、作者、日期、comment。
svn log -r 4:20 #只看版本4到版本20的日誌資訊，順序顯示。
svn log -r 20:5 #顯示版本20到4之間的日誌資訊，逆序顯示。
svn log test.c #檢視檔案test.c的日誌修改資訊。
svn log -r 8 -v #顯示版本8的詳細修改日誌，包括修改的所有檔案列表資訊。
svn log -r 8 -v -q #顯示版本8的詳細提交日誌，不包括comment。
svn log -v -r 88:866 #顯示從版本88到版本866之間，當前程式碼目錄下所有變更的詳細資訊 。
svn log -v dir #檢視目錄的日誌修改資訊,需要加v。
svn log http://foo.com/svn/trunk/code/ #顯示程式碼目錄的日誌資訊。

常用命令

svn add file|dir -- 新增檔案或整個目錄
svn checkout -- 獲取svn程式碼
svn commit -- 提交本地修改程式碼
svn status -- 檢視本地修改程式碼情況：修改的或本地獨有的檔案詳細資訊
svn merge -- 合併svn和原生代碼
svn revert -- 撤銷本地修改程式碼
svn resolve -- 合併衝突程式碼
svn help [command] -- 檢視svn幫助，或特定命令幫助

svn diff個性化定製

svn配置檔案: ~/.subversion/config

修改~/.subversion/config，找到如下配置行：

# diff-cmd = diff_program (diff,gdiff,etc.)
將上面那個指令碼的路徑新增進去就行，修改為

diff-cmd = /usr/local/bin/diffwrap.sh #絕對路徑
這樣svn diff命令就會預設使用vimdiff比較檔案。

diffwrap.sh檔案

#! /bin/bash

# for svn diff: 修改~/.subversion/config，找到如下配置行：
# diff-cmd = diff_program (diff,etc.)
# diff-cmd = ~/bin/diffwrap.sh

# 引數大於5時，去掉前5個引數；引數小於5，失敗，什麼也不做
shift 5

# 使用vimdiff比較
vimdiff "$@"

參考文獻

使用vimdiff作為svn diff的檢視程式碼工具：https://www.jb51.net/LINUXjishu/734861.html

SVN常用命令: http://blog.csdn.net/sunboy_2050/article/details/6187464

svn 常用操作命令

檢出

svn checkout http://路徑(目錄或檔案的全路徑)　[本地目錄全路徑] --username　使用者名稱
svn checkout svn://路徑(目錄或檔案的全路徑)　[本地目錄全路徑] --username　使用者名稱
 
# 例子：
svn co svn://localhost/測試工具 /home/testtools --username wzhnsc
svn co http://localhost/test/testapp --username wzhnsc
svn checkout svn://localhost/測試工具 /home/testtools --username wzhnsc
svn checkouthttp://localhost/test/testapp --username wzhnsc

注：如果不帶--password 引數傳輸密碼的話，會提示輸入密碼，建議不要用明文的--password 選項。
　　 其中 username 與 password前是兩個短線，不是一個。
　　 不指定本地目錄全路徑，則檢出到當前目錄下。

匯出(匯出一個乾淨的不帶.svn資料夾的目錄樹)

svn export [-r 版本號] http://路徑(目錄或檔案的全路徑) [本地目錄全路徑]　--username　使用者名稱
svn export [-r 版本號] svn://路徑(目錄或檔案的全路徑) [本地目錄全路徑]　--username　使用者名稱
svn export 本地檢出的(即帶有.svn資料夾的)目錄全路徑 要匯出的本地目錄全路徑
 
例子：
svn export svn://localhost/測試工具 /home/testtools --username wzhnsc
svn export svn://localhost/test/testapp --username wzhnsc
svn export /home/testapp /home/testtools

注：第一種從版本庫匯出乾淨工作目錄樹的形式是指定URL，
如果指定了修訂版本號，會匯出相應的版本，
如果沒有指定修訂版本，則會匯出最新的，匯出到指定位置。
如果省略 本地目錄全路徑，URL的最後一部分會作為本地目錄的名字。
第二種形式是指定 本地檢出的目錄全路徑 到 要匯出的本地目錄全路徑，所有的本地修改將會保留，
但是不在版本控制下(即沒提交的新檔案，因為.svn資料夾裡沒有與之相關的資訊記錄)的檔案不會拷貝。

新增新檔案

svn　add　檔名
注：告訴SVN伺服器要新增檔案了，還要用svn commint -m真實的上傳上去！
例子：
svn add test.php ＜－ 新增test.php 
svn commit -m “新增我的測試用test.php“ test.php
svn add *.php ＜－ 添加當前目錄下所有的php檔案
svn commit -m “新增我的測試用全部php檔案“ *.php

提交

svn　commit　-m　“提交備註資訊文字“　[-N]　[--no-unlock]　檔名
svn　ci　-m　“提交備註資訊文字“　[-N]　[--no-unlock]　檔名
必須帶上-m引數，引數可以為空，但是必須寫上-m
例子：
svn commit -m “提交當前目錄下的全部在版本控制下的檔案“ * ＜－ 注意這個*表示全部檔案
svn commit -m “提交我的測試用test.php“ test.php
svn commit -m “提交我的測試用test.php“ -N --no-unlock test.php ＜－ 保持鎖就用–no-unlock開關
svn ci -m “提交當前目錄下的全部在版本控制下的檔案“ * ＜－ 注意這個*表示全部檔案
svn ci -m “提交我的測試用test.php“ test.php
svn ci -m “提交我的測試用test.php“ -N --no-unlock test.php ＜－ 保持鎖就用–no-unlock開關

更新檔案

svn　update
svn　update　-r　修正版本　檔名
svn　update　檔名
例子：
svn update ＜－ 後面沒有目錄，預設將當前目錄以及子目錄下的所有檔案都更新到最新版本
svn update -r 200 test.cpp ＜－ 將版本庫中的檔案 test.cpp 還原到修正版本（revision）200
svn update test.php ＜－ 更新與版本庫同步。
　　　　　　　　　　　 提交的時候提示過期衝突，需要先 update 修改檔案，
　　　　　　　　　　　 然後清除svn resolved，最後再提交commit。

刪除檔案

svn　delete　svn://路徑(目錄或檔案的全路徑) -m “刪除備註資訊文字”
推薦如下操作：
svn　delete　檔名 
svn　ci　-m　“刪除備註資訊文字”
例子：
svn delete svn://localhost/testapp/test.php -m “刪除測試檔案test.php”
推薦如下操作：
svn delete test.php 
svn ci -m “刪除測試檔案test.php”

加鎖/解鎖

svn　lock　-m　“加鎖備註資訊文字“　[--force]　檔名 
svn　unlock　檔名
例子：
svn lock -m “鎖信測試用test.php檔案“ test.php 
svn unlock test.php

比較差異

svn　diff　檔名 
svn　diff　-r　修正版本號m:修正版本號n　檔名
例子：
svn diff test.php＜－ 將修改的檔案與基礎版本比較
svn diff -r 200:201 test.php＜－ 對 修正版本號200 和 修正版本號201 比較差異

檢視檔案或者目錄狀態

svn st 目錄路徑/名
svn status 目錄路徑/名＜－ 目錄下的檔案和子目錄的狀態，正常狀態不顯示 
　　　　　　　　　　　　　【?：不在svn的控制中； M：內容被修改；C：發生衝突；
　　　　　　　　　　　　　　A：預定加入到版本庫；K：被鎖定】 
svn -v 目錄路徑/名
svn status -v 目錄路徑/名＜－ 顯示檔案和子目錄狀態
　　　　　　　　　　　　　　【第一列保持相同，第二列顯示工作版本號，
　　　　　　　　　　　　　　 第三和第四列顯示最後一次修改的版本號和修改人】 

注：svn status、svn diff和 svn revert這三條命令在沒有網路的情況下也可以執行的，
　　原因是svn在本地的.svn中保留了本地版本的原始拷貝。

檢視日誌

svn　log　檔名
例子：
svn log test.php＜－ 顯示這個檔案的所有修改記錄，及其版本號的變化 

檢視檔案詳細資訊

svn　info　檔名
例子：
svn info test.php

SVN 幫助

svn　help ＜－ 全部功能選項
svn　help　ci ＜－ 具體功能的說明

檢視版本庫下的檔案和目錄列表

svn　list　svn://路徑(目錄或檔案的全路徑)
svn　ls　svn://路徑(目錄或檔案的全路徑)
例子：
svn list svn://localhost/test
svn ls svn://localhost/test ＜－ 顯示svn://localhost/test目錄下的所有屬於版本庫的檔案和目錄 

建立納入版本控制下的新目錄

svn　mkdir　目錄名
svn　mkdir　-m　"新增目錄備註文字"　http://目錄全路徑
例子：
svn mkdir newdir
svn mkdir -m "Making a new dir." svn://localhost/test/newdir 

注：新增完子目錄後，一定要回到根目錄更新一下，不然在該目錄下提交檔案會提示“提交失敗”

svn update

注：如果手工在checkout出來的目錄裡建立了一個新資料夾newsubdir，
　　再用svn mkdir newsubdir命令後，SVN會提示：
　　svn: 嘗試用 “svn add”或 “svn add --non-recursive”代替？
　　svn: 無法建立目錄“hello”: 檔案已經存在
　　此時，用如下命令解決：
　　svn add --non-recursive newsubdir
　　在進入這個newsubdir資料夾，用ls -a檢視它下面的全部目錄與檔案，會發現多了：.svn目錄
　　再用 svn mkdir -m "添hello功能模組檔案" svn://localhost/test/newdir/newsubdir 命令，
　　SVN提示：
　　svn: File already exists: filesystem '/data/svnroot/test/db',transaction '4541-1',
　　path '/newdir/newsubdir '

恢復本地修改

svn　revert　[--recursive]　檔名
注意: 本子命令不會存取網路，並且會解除衝突的狀況。但是它不會恢復被刪除的目錄。
例子：
svn revert foo.c ＜－ 丟棄對一個檔案的修改
svn revert --recursive . ＜－恢復一整個目錄的檔案，. 為當前目錄 

把工作拷貝更新到別的URL

svn　switch　http://目錄全路徑　本地目錄全路徑
例子：
svn switch http://localhost/test/456 . ＜－ (原為123的分支)當前所在目錄分支到localhost/test/456

解決衝突

svn　resolved　[本地目錄全路徑]
例子：
$ svn update
C foo.c
Updated to revision 31.
如果你在更新時得到衝突，你的工作拷貝會產生三個新的檔案：
$ ls
foo.c
foo.c.mine
foo.c.r30
foo.c.r31
當你解決了foo.c的衝突，並且準備提交，執行svn resolved讓你的工作拷貝知道你已經完成了所有事情。
你可以僅僅刪除衝突的檔案並且提交，但是svn resolved除了刪除衝突檔案，還修正了一些記錄在工作拷貝管理區域的記錄資料，所以我們推薦你使用這個命令。

不checkout而檢視輸出特定檔案或URL的內容

svn　cat　http://檔案全路徑
例子：
svn cat http://localhost/test/readme.txt
19、新建一個分支copy
svn copy branchA branchB -m "make B branch" // 從branchA拷貝出一個新分支branchB
20、合併內容到分支merge
svn merge branchA branchB // 把對branchA的修改合併到分支branchB

1、將檔案checkout到本地目錄

svn checkout path（path是伺服器上的目錄）
例如：svn checkout svn://192.168.1.1/pro/domain
簡寫：svn co

2、往版本庫中新增新的檔案

svn add file
例如：svn add test.php(新增test.php)
svn add *.php(添加當前目錄下所有的php檔案)

3、將改動的檔案提交到版本庫

svn commit -m "LogMessage" [-N] [--no-unlock] PATH(如果選擇了保持鎖，就使用--no-unlock開關)
例如：svn commit -m "add test file for my test" test.php

簡寫：svn ci

4、加鎖/解鎖

svn lock -m "LockMessage" [--force] PATH
例如：svn lock -m "lock test file" test.php
svn unlock PATH

5、更新到某個版本

svn update -r m path
例如：
svn update如果後面沒有目錄，預設將當前目錄以及子目錄下的所有檔案都更新到最新版本。
svn update -r 200 test.php(將版本庫中的檔案test.php還原到版本200)
svn update test.php(更新，於版本庫同步。如果在提交的時候提示過期的話，是因為衝突，需要先update，修改檔案，然後清除svn resolved，最後再提交commit)

簡寫：svn up

6、檢視檔案或者目錄狀態

1）svn status path（目錄下的檔案和子目錄的狀態，正常狀態不顯示）
【?：不在svn的控制中；M：內容被修改；C：發生衝突；A：預定加入到版本庫；K：被鎖定】
2）svn status -v path(顯示檔案和子目錄狀態)
第一列保持相同，第二列顯示工作版本號，第三和第四列顯示最後一次修改的版本號和修改人。
注：svn status、svn diff和 svn revert這三條命令在沒有網路的情況下也可以執行的，原因是svn在本地的.svn中保留了本地版本的原始拷貝。
簡寫：svn st

7、刪除檔案

svn delete path -m "delete test fle"
例如：svn delete svn://192.168.1.1/pro/domain/test.php -m "delete test file"
或者直接svn delete test.php 然後再svn ci -m 'delete test file‘，推薦使用這種
簡寫：svn (del,rm)

8、檢視日誌

svn log path
例如：svn log test.php 顯示這個檔案的所有修改記錄，及其版本號的變化

9、檢視檔案詳細資訊

svn info path
例如：svn info test.php
10、比較差異

svn diff path(將修改的檔案與基礎版本比較)
例如：svn diff test.php
svn diff -r m:n path(對版本m和版本n比較差異)
例如：svn diff -r 200:201 test.php
簡寫：svn di

11、將兩個版本之間的差異合併到當前檔案

svn merge -r m:n path
例如：svn merge -r 200:205 test.php（將版本200與205之間的差異合併到當前檔案，但是一般都會產生衝突，需要處理一下）

12、SVN 幫助

svn help
svn help ci

以上是常用命令，下面寫幾個不經常用的

13、版本庫下的檔案和目錄列表

svn list path
顯示path目錄下的所有屬於版本庫的檔案和目錄

簡寫：svn ls

14、建立納入版本控制下的新目錄

svn mkdir: 建立納入版本控制下的新目錄。
用法: 1、mkdir PATH...
2、mkdir URL...

15、恢復本地修改

svn revert: 恢復原始未改變的工作副本檔案 (恢復大部份的本地修改)。revert:
用法: revert PATH...
注意: 本子命令不會存取網路，並且會解除衝突的狀況。但是它不會恢復
被刪除的目錄

16、程式碼庫URL變更

svn switch (sw): 更新工作副本至不同的URL。
用法: 1、switch URL [PATH]
2、switch --relocate FROM TO [PATH...]

1、更新你的工作副本，對映到一個新的URL，其行為跟“svn update”很像，也會將
伺服器上檔案與本地檔案合併。這是將工作副本對應到同一倉庫中某個分支或者標記的
方法。
2、改寫工作副本的URL元資料，以反映單純的URL上的改變。當倉庫的根URL變動
(比如方案名或是主機名稱變動)，但是工作副本仍舊對映到同一倉庫的同一目錄時使用
這個命令更新工作副本與倉庫的對應關係。

17、解決衝突

svn resolved: 移除工作副本的目錄或檔案的“衝突”狀態。
用法: resolved PATH...
注意: 本子命令不會依語法來解決衝突或是移除衝突標記；它只是移除衝突的
相關檔案，然後讓 PATH 可以再次提交。

18、輸出指定檔案或URL的內容。

svn cat 目標[@版本]...如果指定了版本，將從指定的版本開始查詢。
svn cat -r PREV filename > filename (PREV 是上一版本,也可以寫具體版本號,這樣輸出結果是可以提交的)