Linux ubuntu下svn的命令使用指南

Svn簡介：

Svn的全名是Subversion，它使用服務端—客戶端的結構，當然服務端與客戶端可以都運行在同一台服務器上。在服務端是存放着所有受控制數據的Subversion倉庫，另一端是Subversion的客戶端程序，管理着受控數據的一部分在本地的映射(稱為工作副本)。在這兩端之間，是通過各種倉庫存取層(RepositoryAccess，簡稱RA)的多條通道進行訪問的。這些通道中，可以通過不同的網絡協議，例如HTTP、SSH等，或本地文件的方式來對倉庫進行操作。

 

Subversion是一種開放源碼的全新版本控制系統，支持可在本地訪問或通過網絡訪問的數據庫和文件系統存儲庫。不但提供了常見的比較、修補、標記、提交、回復和分支功能性，Subversion還增加了追蹤移動和刪除的能力。此外，它支持非ASCII文本和二進制數據，所有這一切都使Subversion不僅對傳統的編程任務非常有用，同時也適於Web 開發、圖書創作和其他在傳統方式下未采納版本控制功能的領域.

 

Subversion的官方網站是：http://subversion.tigris.org/

 

大部分的發行版都已經提供Subversion套件,ubuntu下安裝subversion客戶端:

sudo apt-get installsubversion

 

使用Subversion

　　Subversion一般使用兩種后台服務模式：一種是其自己實現的svnserve，可以通過svn協議訪問，另一種是借助mod_dav_svn模塊，由Apachehttp服務器來實現，然后通過HTTP或HTTPS協議來訪問。

1、通過svn協議訪問

　　svn協議

　　客戶端若要通過svn協議訪問倉庫，必須在存放倉庫的機器上運行svnserve服務程序。啟動該程序后，會監聽在3690端口，以響應客戶端的訪問工作。

 

2、通過HTTP協議訪問版本庫

　　通過HTTP協議訪問版本庫是Subversion的亮點之一，這種方式具備許多svnserve服務器所沒有的特性，使用上更加靈活。

 

以下是svn常用的一些命令，詳細請看http://www.subversion.org.cn/svnbook/1.1/index.html

 

1. 將文件checkout到本地目錄

命令：checkout或co

示例：

I、svn co http://路徑(目錄或文件的全路徑)　[本地目錄全路徑] --username 用戶名--password 密碼

II、svn co svn://路徑(目錄或文件的全路徑)　[本地目錄全路徑] --username 用戶名--password 密碼

III、svn checkout http://路徑(目錄或文件的全路徑)　[本地目錄全路徑] --username　用戶名

IV、svn checkout svn://路徑(目錄或文件的全路徑)　[本地目錄全路徑] --username　用戶名

 

注意事項：

1、如果不帶--password參數傳輸密碼的話，會提示輸入密碼，建議不要用明文的--password選項。推薦使用示例c、d，其執行之后會提示輸入密碼

2、其中username 與password前是兩個短線，不是一個。

3、若不指定本地目錄全路徑，則檢出到當前目錄下。

 

例子：

svn cosvn://192.168.0.6/test /home/test --username xxx

svn cohttp://192.168.0.6/test/testapp --username xxx

svn checkoutsvn://192.168.0.6/ test /home/ test --username xxx

svn checkouthttp://192.168.0.3/test/testapp --username xxx

 

2、添加新文件

命令：svn　add

svn　add　文件名

注：告訴SVN服務器要添加文件了，還要用svncommint -m真實的上傳上去！

例子：

I、svnadd test.c ＜－添加test.c

svn commint -m “添加測試用test.c“test.php

 

II、svnadd *.c ＜－添加當前目錄下所有的c文件

svn commint -m“添加測試用全部c文件“*.c

 

3、導出(導出一個干凈的不帶.svn文件夾的目錄)

命令：svn export

svn export [-r 版本號] http://路徑(目錄或文件的全路徑)[本地目錄全路徑]　--username　用戶名

svn export [-r 版本號] svn://路徑(目錄或文件的全路徑)[本地目錄全路徑]　--username　用戶名

svn export 本地檢出的(即帶有.svn文件夾的)目錄全路徑 要導出的本地目錄全路徑

 

注：第一種從版本庫導出干凈工作目錄樹的形式是指定URL，

　　　如果指定了修訂版本號，會導出相應的版本，

　　　如果沒有指定修訂版本，則會導出最新的，導出到指定位置。

　　　如果省略本地目錄全路徑，URL的最后一部分會作為本地目錄的名字。

　　

第二種形式是指定本地檢出的目錄全路徑到要導出的本地目錄全路徑，所有的本地修改將會保留，但是不在版本控制下(即沒提交的新文件，因為.svn文件夾里沒有與之相關的信息記錄)的文件不會拷貝。

例子：

svn exportsvn://192.168.0.3/ test /home/ test --username xxx

svn exporthttp://192.168.0.3/test/testapp --username xxx

svn export /home/ test/home/ testbak

 

4、將改動的文件提交到版本庫

命令：svn　commint或svn　ci

 

svn　commint　-m　“提交備注信息文本“　[-N]　[--no-unlock]　文件名

svn　ci　-m　“提交備注信息文本“　[-N]　[--no-unlock]　文件名

svn commit -m"LogMessage" [-N] [--no-unlock]PATH(如果選擇了保持鎖,就使用–no-unlock開關)

 

必須帶上-m參數，參數可以為空，但是必須寫上-m

例子：

svn commint -m“提交當前目錄下的全部在版本控制下的文件“* ＜－注意這個*表示全部文件

svn commint -m“提交測試用test.c“test.c

 

svn commint -m“提交測試用test.c“-N --no-unlock test.c ＜－保持鎖就用–no-unlock開關

 

svn ci -m“提交當前目錄下的全部在版本控制下的文件“* ＜－注意這個*表示全部文件

 

svn ci -m “提交測試用test.c“test.c

 

svn ci -m “提交測試用test.c“-N --no-unlock test.c ＜－保持鎖就用–no-unlock開關

 

5、更新文件

命令：svn　update或svn up

 

svn　update　-r　修正版本　文件名

svn　update　文件名

 

例子：

svn update ＜－后面沒有目錄，默認將當前目錄以及子目錄下的所有文件都更新到最新版本

svn update -r 1300test.c ＜－將版本庫中的文件test.c 還原到修正版本（revision）1300

svn update test.c ＜－更新與版本庫同步。

 

提交的時候提示過期沖突，需要先update 修改文件，

然后清除svnresolved，最后再提交commit。

 

6、刪除文件

命令：svn　delete或svn del, svnremove, svnrm

svn　delete　svn://路徑(目錄或文件的全路徑)-m “刪除備注信息文本”

推薦如下操作：

svn　delete　文件名

svn　ci　-m　“刪除備注信息文本”

例子：

svn deletesvn://192.168.1.1/ trunk /main /test.c -m “刪除測試文件test.c”

 

推薦如下操作：

svn delete test.c

svn ci -m“刪除測試文件test.c”

 

svn delete path -m"delete test fle"

例如：svndelete svn://192.168.1.1/ trunk /main/test.c -m "delete testfile"

或者直接svndelete test.c 然后再svnci -m ‘delete test file‘,推薦使用這種

 

７、加鎖/解鎖

命令：svn　lock

svn　lock　-m　“加鎖備注信息文本“　[--force]　文件名

svn　unlock　文件名

svn lock -m"LockMessage" [--force] PATH

例如：svnlock -m "lock test file" test.c

svn unlock PATH

 

例子：

svn lock -m“鎖信測試用test.c文件“test.c

svn unlock test.php

 

8、比較差異

命令：svn　diff

svn　diff　文件名

svn　diff　-r　修正版本號m:修正版本號n　文件名

例子：

svn diff test.php＜－將修改的文件與基礎版本比較

svn diff -r 200:201test.php＜－對 修正版本號200和修正版本號201 比較差異

 

svn diffpath(將修改的文件與基礎版本比較)

例如：svndiff test.php

svn diff -r m:npath(對版本m和版本n比較差異)

例如：svndiff -r 200:201 test.php

簡寫：svndi

 

9、將兩個版本之間的差異合並到當前文件

命令：svnmerge

svn merge -r m:n path

例如：svnmerge -r 200:205 test.php（將版本200與205之間的差異合並到當前文件,但是一般都會產生沖突,需要處理一下）

 

10、查看文件或者目錄狀態

命令：svnstatus 或svnst

 

svn st 目錄路徑/名

svn status 目錄路徑/名＜－目錄下的文件和子目錄的狀態，正常狀態不顯示

　　　　　　　　　　　　　【?：不在svn的控制中； M：內容被修改；C：發生沖突；

　　　　　　　　　　　　　　A：預定加入到版本庫；K：被鎖定】

svn -v 目錄路徑/名

svn status -v 目錄路徑/名＜－顯示文件和子目錄狀態

　　　　　　　　　　　　　　【第一列保持相同，第二列顯示工作版本號，

　　　　　　　　　　　　　　　第三和第四列顯示最后一次修改的版本號和修改人】

 

注：svnstatus、svndiff和svn revert這三條命令在沒有網絡的情況下也可以執行的，

　　原因是svn在本地的.svn中保留了本地版本的原始拷貝。

 

1）svnstatus path（目錄下的文件和子目錄的狀態,正常狀態不顯示）

【?：不在svn的控制中；M：內容被修改；C：發生沖突；A：預定加入到版本庫；K：被鎖定】

2）svnstatus -v path(顯示文件和子目錄狀態)

第一列保持相同,第二列顯示工作版本號,第三和第四列顯示最后一次修改的版本號和修改人.

注：svnstatus、svndiff和svnrevert這三條命令在沒有網絡的情況下也可以執行的,原因是svn在本地的.svn中保留了本地版本的原始拷貝.

簡寫：svnst

 

11、查看日志

命令：svn　log　

svn　log　文件名

svn log path

例子：

svn log test.php＜－顯示這個文件的所有修改記錄，及其版本號的變化

 

12、查看文件詳細信息

命令：svn　info　

svn　info　文件名

svn info path

例子：

svn info test.php

 

13、SVN幫助

命令：svn　help

svn　help＜－全部功能選項

svn　help　ci＜－具體功能的說明

 

14、查看版本庫下的文件和目錄列表

命令：svn　list或svn　ls

svn　list　svn://路徑(目錄或文件的全路徑)

svn　ls　svn://路徑(目錄或文件的全路徑)

例子：

svn listsvn://192.168.0.3/test

svn lssvn://192.168.0.3/test ＜－顯示svn://192.168.0.3/test目錄下的所有屬於版本庫的文件和目錄

 

15、創建納入版本控制下的新目錄

命令：svn　mkdir

svn　mkdir　目錄名

svn　mkdir　-m　"新增目錄備注文本"　http://目錄全路徑

創建版本控制的目錄.

1、每一個以工作副本PATH 指定的目錄,都會創建在本地端,並且加入新增

調度,以待下一次的提交.

2、每個以URL指定的目錄,都會透過立即提交於倉庫中創建.

在這兩個情況下,所有的中間目錄都必須事先存在.

例子：

svn mkdir newdir

svn mkdir -m "Makinga new dir." http://192.168.0.3/test/newdir

注：添加完子目錄后，一定要回到根目錄更新一下，不然在該目錄下提交文件會提示“提交失敗”

svn update

注：如果手工在checkout出來的目錄里創建了一個新文件夾newsubdir，

　　再用svnmkdir newsubdir命令后，SVN會提示：

　　svn:嘗試用“svn add”或“svn add --non-recursive”代替？

　　svn:無法創建目錄“hello”:文件已經存在

　　此時，用如下命令解決：

　　svnadd --non-recursive newsubdir

　　在進入這個newsubdir文件夾，用ls-a查看它下面的全部目錄與文件，會發現多了：.svn目錄

　　再用svn mkdir -m "添hello功能模塊文件"svn://192.168.0.3/test/newdir/newsubdir 命令，

　　SVN提示：

　　svn:File already exists: filesystem '/data/svnroot/test/db', transaction'4541-1',

　　path'/newdir/newsubdir '

 

16、恢復本地修改,恢復原始未改變的工作副本文件

命令：svn　revert　

svn　revert　[--recursive]　文件名

注意:本子命令不會存取網絡，並且會解除沖突的狀況。但是它不會恢復被刪除的目錄。

例子：

svn revert foo.c ＜－丟棄對一個文件的修改

svn revert --recursive. ＜－恢復一整個目錄的文件，.為當前目錄

 

17、代碼庫URL變更,把工作拷貝更新到別的URL

命令：svn　switch或svnsw

svn　switch　http://目錄全路徑　本地目錄全路徑

例子：

svn switchhttp://192.163.0.3/test/456 . ＜－(原為123的分支)當前所在目錄分支到192.163.0.3/test/456

 

 

svn switch (sw):更新工作副本至不同的URL.

用法:1、switchURL [PATH]

2、switch–relocate FROM TO [PATH...]

 

1、更新你的工作副本,映射到一個新的URL,其行為跟“svnupdate”很像,也會將

服務器上文件與本地文件合並.這是將工作副本對應到同一倉庫中某個分支或者標記的

方法.

2、改寫工作副本的URL元數據,以反映單純的URL上的改變.當倉庫的根URL變動

(比如方案名或是主機名稱變動),但是工作副本仍舊對映到同一倉庫的同一目錄時使用

這個命令更新工作副本與倉庫的對應關系.

 

18、解決沖突, 移除工作副本的目錄或文件的“沖突”狀態.

命令：svn　resolved

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的沖突，並且准備提交，運行svnresolved讓你的工作拷貝知道你已經完成了所有事情。

你可以僅僅刪除沖突的文件並且提交，但是svnresolved除了刪除沖突文件，還修正了一些記錄在工作拷貝管理區域的記錄數據，所以我們推薦你使用這個命令。

 

注意:本子命令不會依語法來解決沖突或是移除沖突標記；它只是移除沖突的

相關文件,然后讓PATH 可以再次提交.

 

19、不checkout而查看輸出特定文件或URL的內容

命令：svn　cat　

svn　cat　http://文件全路徑

svn cat目標[@版本]…如果指定了版本,將從指定的版本開始查找.

svn cat -r PREVfilename > filename (PREV 是上一版本

例子：

svn cathttp://192.168.0.3/test/readme.txt