svn 命令列基本操作

標籤：blog   http   io   os   使用   java   ar   strong   for   

以下是我常用到的svn 命令列，整理了一下，這東西版本控制上很有用，所以不會不行，當然，你也可以選擇一些svn圖形介面的工具0 查看當前工作目錄svn 狀態簡寫：svn st1、將檔案checkout到本地目錄
svn checkout path（path是伺服器上的目錄）
簡寫：svn co

2、往版本庫中添加新的檔案
svn add file

3、將改動的檔案提交到版本庫
svn commit -m “LogMessage” [-N] [--no-unlock] PATH(如果選擇了保持鎖，就使用–no-unlock開關)
簡寫：svn ci

4、加鎖/解鎖
svn lock -m “LockMessage” [--force] PATH
svn unlock PATH

5、更新到某個版本
svn update -r m path
簡寫：svn up

6、查看檔案或者目錄狀態
1）svn status path（目錄下的檔案和子目錄的狀態，正常狀態不顯示）
2）svn status -v path(顯示檔案和子目錄狀態)
簡寫：svn st

7、刪除檔案
svn delete path -m “delete test fle”
簡寫：svn (del, remove, rm)

8、查看日誌
svn log path

9、查看檔案詳細資料
svn info path

10、比較差異
svn diff path(將修改的檔案與基礎版本比較)
svn diff -r m:n path(對版本m和版本n比較差異)
簡寫：svn di

11、將兩個版本之間的差異合并到當前檔案
svn merge -r m:n path

12、SVN 協助
svn help
svn help ci

 

 

 

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, 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: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 是上一版本,也可以寫具體版本號碼,這樣輸出結果是可以提交的)

 

 

 

 

 

SVN版本：1.5 及更新版本

名詞說明：

WC：Working Copy 你的工作區

Versioned：受控的；受版本控制的

 

SVN是什嗎？

 

• SVN是開源的版本控制系統。
• 比CVS更多的特性。一個更好的CVS？因此SVN具有大部分CVS擁有的特性。
• 不僅僅是檔案受控，目錄也加入版本控制。
• 複製，刪除，重新命名這些操作都是受控的。
• 特殊作用的中繼資料（屬性）。
• 提交事務原子性。提交完成之前任何一個部分都不會正真生效。版本號碼基於提交，而不是基於檔案。提交時的log message也是依附於提交的那個版本。
• 建立分支和標記非常簡單。簡單的通過copy命令就可以建立分支和標記。
• 合并跟蹤。在合并時協助你處理所有的更改點。
• 檔案鎖定。svn支援檔案鎖定修改策略。
• Unix的link可以受控了。前提是WC必須在Unix下。
• 可選的Apache network server，基於WEBDAV/DeltaV 協議。熟悉Apache的管理員會很喜歡這一點。
• 內建的server選擇（svnserve）。如果不想用Apache，可以試試Svn自己的server：svnserve。同樣也能提供授權和驗證，ssh通道等功能。
• 方便解析的輸出。svn的輸出盡量做到方便閱讀和方便機器解析。
• 衝突解決互動性良好。svn命令列用戶端提供多種不同的方式解決衝突。
• svn提供一個工具 + 生產力，svnsync來實現從主庫到唯讀附屬庫的同步。
• 持續寫入代理功能讓唯讀附屬庫專門處理所有的讀請求。所有的寫請求交給主庫處理。這個功能只在使用Apache WebDAV server的時候才有效。
• 基於本地化的客戶機伺服器體系，分層的庫，明晰的API方便擴充。
• 高效處理二進位檔案。
• 效能消耗與更改點的數量成正比。
• svn的api可以和多種語言整合。Python，Perl,Java,Ruby（svn本身是用C寫的）
• ChangeLists功能。

Svn的安裝分用戶端和服務端。

你可以在如下地址找到下載：http://subversion.tigris.org/

這篇文章主要介紹的是svn用戶端的命令，你至少需要安裝用戶端。預設就是以SVN做版本控制的。如果你不想在自己機器上安裝服務版，google code是個練習svn命令的好地方。

http://code.google.com上申請託管項目很簡單，但是現在不支援svn lock。目前最大支援1G空間。

 

以下是svn用戶端常用命令一覽：

 

svn add [path]

別名：無

描述：添加檔案或目錄到你的wc，打上新增標記。這些檔案會在下一次你提交wc的時候提交到svn伺服器。

在提交前，你也可以用svn revert撤銷新增的檔案。

訪問庫：否

eg: svn add file.cpp

 

svn blame Target[@REV]

別名：praise,annotate,ann

描述：顯示某個已受控檔案的每一行的最後修改版本和作者

訪問庫：是

eg: svn blame file.cpp

eg: svn blame --xml file.cpp  ##加上xml參數可以以xml格式顯示每一行的屬性。

 

svn cat TARGET[@REV]

別名：無

描述：輸出指定目標的內容，這裡的目標一般是檔案。

訪問庫：是

eg:svn cat file.cpp

eg:svn cat file.cpp -r 2 ##顯示版本號碼為二的file.cpp內容。

eg:svn cat file.cpp --revision HEAD ##顯示最新版本的file.cpp內容。

 

svn changelist CLNAME TARGET...

svn changelist --remove TARGET

別名：cl

描述：可以將wc中的檔案從邏輯上分組.

訪問庫：否

eg:svn cl clName file.cpp file2.cpp file3.cpp  ##將file.cpp等三個檔案加入名叫clName的changelist 

eg:svn commit --changelist clName -m "ci"  ##將clName下的所有檔案提交

 

svn checkout URL[@REV]... [PATH]

別名：co

描述：檢出

訪問庫：否

eg:svn checkout file:///var/svn/repos/test  file:///var/svn/repos/quiz working-copies

eg:svn checkout -r 2 file:///var/svn/repos/test mine  ##check out 版本號碼為2的項目

 

svn cleanup [PATH...]

別名：無

描述：遞迴的清理WC中到期的鎖和未完成的操作。

訪問庫：否

eg：svn cleanup

 

svn commit [PATH...]

別名：ci

描述：把你WC的更改提交到倉庫

訪問庫：是

eg：svn commit -m "added howto section." ##預設情況下提交必須提供log message 

 

svn copy SRC[@REV]... DST

別名：cp

描述:copy操作可以從WC到WC；WC到URL；URL到WC；URL到URL。現在SVN只支援同一個倉庫內檔案的拷貝，不允許跨倉庫操作。

訪問庫：是

eg：svn copy -r 11 file:///var/svn/repos/test/trunk \

           file:///var/svn/repos/test/tags/0.6.32-prerelease \

           -m "Forgot to tag at rev 11"

##copy命令是建立分支和標記的常用方式。copy到url的操作隱含了提交動作，所以需要提供log messages。

 

svn delete PATH...

別名：del，remove，rm

描述：刪除

訪問庫：如果PATH是庫地址時會，刪除WC內的檔案不會。

eg：svn del localfile.cpp    ##刪除WC裡的檔案，在下一次提交WC的時候才會真正在倉庫裡將對應檔案刪除。

eg: svn del file:///var/svn/repos/test/yourfile  ##刪除倉庫裡的檔案

 

svn diff

別名：di

描述：用來比較並顯示修改點。

訪問庫：

eg：svn diff   ##最常用的方式，用來顯示WC基於最近一次更新以後的所有的本地修改點。

eg：svn diff -r 301 bin ## 比較WC和版本301中的bin目錄的修改點

eg：svn diff -r 3000:3500 file:///var/svn/repos/myProject/trunk   ##比較庫裡主幹3000版和3500版的差異。

eg：svn diff --summarize --xml http://svn.red-bean.com/repos/[email protected] http://svn.red-bean.com/repos/test  ##--summarize --xml 參數將差異情況以xml文檔的方式顯示出來。

 

svn export [-r REV] URL[@PEGREV] [PATH]

svn export [-r REV] PATH1[@PEGREV] [PATH2]

別名：無

描述：匯出一個乾淨的分類樹，不包含所有的受控資訊。可以選擇從URL或WC中匯出。

訪問庫：如果訪問的是URL則會。

eg：svn export file:///var/svn/repos my-export   ##匯出到my-export目錄。

 

svn help — Help!

別名：?,h

描述：不用解釋了

訪問庫：否。

 

svn import [PATH] URL

別名：無

描述：匯入本地一個目錄到庫中。但是匯入後，本地的目錄並不會處於受控狀態。

訪問庫：是。

eg：svn import -m "New import" myproj http://svn.myProject.com/repos/trunk/misc

 

svn info [TARGET[@REV]...]

別名：無

描述：顯示指定WC和URL資訊。

訪問庫：僅當訪問的是庫路徑時。

eg：svn info --xml http://svn.myProject.com/repos/test  ##將資訊以xml格式顯示。

 

svn list [TARGET[@REV]...]

別名：ls

描述：顯示目標下的檔案和目錄列表。

訪問庫：如果訪問的是庫地址就會。

eg：svn list --verbose file:///var/svn/repos   ##--verbose參數表示顯示詳細資料。

 

svn lock TARGET...

別名：無

描述：對目標獲得修改鎖。如果目標已被其他使用者鎖定，則會拋出警告資訊。用--force參數強制從其他使用者那裡獲得鎖。

訪問庫：是

eg：svn lock --force tree.jpg

 

svn log [PATH]

svn log URL[@REV] [PATH...]

別名：無

描述：從庫中顯示log訊息。log訊息代碼 A ：added  D：deleted  M：modified  R：replaced

訪問庫：是

eg：svn log -v http://svn.myProject.com/repos/test/ foo.c bar.c   ##詳細顯示指定URL的庫中foo.c和bar.c所有版本的log資訊。

eg：svn log -r 14:15    ##顯示當前WC的14和15版本log資訊。

eg：##如果版本號碼不連續，只能採用如下方式。

$ svn log -r 14 > mylog

$ svn log -r 19 >> mylog

$ svn log -r 27 >> mylog

 

svn merge sourceURL1[@N] sourceURL2[@M] [WCPATH]

svn merge [email protected] [email protected] [WCPATH]

svn merge [[-c M]... | [-r N:M]...] [SOURCE[@REV] [WCPATH]]

別名：無

描述：合并兩個受控源的不同之處，存放到一個WC裡。

訪問庫：只有當訪問庫地址時。

eg：svn merge --reintegrate http://svn.example.com/repos/calc/branches/my-calc-branch  ##合并分支上的改變項到WC，往往用於分支合并到主幹。

eg：svn merge -r 156:157 http://svn.example.com/repos/calc/branches/my-calc-branch   ##將制定URL版本156到157的所有更新合并到WC。

 

svn mkdir PATH...

svn mkdir URL...

別名：無

描述：在WC或庫路徑建立目錄

訪問庫：只有當訪問庫地址時。

eg：svn mkdir newdir

 

svn move SRC... DST

別名：mv, rename, ren

描述：等同於svn copy命令跟個svn delete命令。WC到URL的重新命名是不被允許的。

訪問庫：只有當訪問庫地址時。

eg：svn move foo.c bar.c  ##將foo.c改名成bar.c。

 

svn propdel PROPNAME [PATH...]

svn propdel PROPNAME --revprop -r REV [TARGET]

別名：pdel, pd

描述：從受控檔案，目錄等刪除屬性。第二種是刪除某個指定版本上的附加屬性。

訪問庫：只有當訪問庫地址時。

eg：svn propdel svn:mime-type someFile    ##從someFile上移除svn:mime-type這個屬性。

 

svn propedit PROPNAME TARGET...

svn propedit PROPNAME --revprop -r REV [TARGET]

別名：pedit, pe

描述：編輯屬性

訪問庫：只有當訪問庫地址時。

eg：svn propedit svn:keywords  file.c  ##修改file.c上的svn:keywords屬性。

 

svn propget PROPNAME [TARGET[@REV]...]

svn propget PROPNAME --revprop -r REV [URL]

別名：pget,pg

描述：從檔案，目錄或版本取得指定屬性的值。

訪問庫：只有當訪問庫地址時。

eg：svn propget svn:keywords file.c   ##從file.c中取得svn:keywords屬性的值

 

svn proplist [TARGET[@REV]...]

svn proplist --revprop -r REV [TARGET]

別名：plist, pl

描述：列出檔案、目錄或版本上的所有附加屬性

訪問庫：只有當訪問庫地址時。

eg：svn proplist --verbose file.c

 

svn propset PROPNAME [PROPVAL | -F VALFILE] PATH...

svn propset PROPNAME --revprop -r REV [PROPVAL | -F VALFILE] [TARGET]

別名：pset,ps

描述：給檔案、目錄或版本附加屬性並賦值

訪問庫：只有當訪問庫地址時。

eg：svn propset svn:mime-type image/jpeg file.jpg   ##給file.jpg附加屬性svn:mime-type 其值為image/jpeg

eg:svn propset --revprop -r 25 svn:log "Journaled about trip to New York."

##給版本25補上log message

eg:svn propset svn:ignore ‘.classpath‘ . 

##在本地忽略掉.classpath檔案

 

svn resolve PATH...

別名：無

描述：將衝突的檔案標記為已解決，並且刪掉衝突產生的臨時檔案。注意這個命令並不是能把衝突解決，解決衝突還是得靠人工。

訪問庫：否

eg：svn resolve --accept mine-full foo.c   ##1.5版本後，加上--accept參數，嘗試自動處理衝突。

 

svn resolved PATH...

別名：無

描述：已淘汰，被resolve --accept取代。去除衝突的狀態和衝突臨時檔案。

訪問庫：否

 

svn revert PATH...

別名：無

描述：還原WC中所有的本地更改。

訪問庫：否

eg：svn revert --depth=infinity .   ##將整個目錄所有檔案還原

 

svn status [PATH...]

別名：stat, st

描述：輸出WC中檔案和目錄的狀態。如果WC提交，這些狀態就會同步到庫裡。

一般狀態有         ‘ ‘  沒有修改

‘A‘  新增

‘D‘  刪除

‘M‘  修改

‘R‘  替代

‘C‘  衝突

‘I‘  忽略

‘?‘  未受控

‘!‘  丟失，一般是將受控檔案直接刪除導致

訪問庫：加上--show-updates參數時會

eg：svn status wc

 

svn switch URL[@PEGREV] [PATH]

svn switch --relocate FROM TO [PATH...]

別名：sw

描述：將WC轉向一個其他的庫地址同步

訪問庫：是

eg：svn sw http://svn.myProject.com/repos/trunk/vendors .  ##將當前WC切換到另一個URL

 

svn unlock TARGET...

別名：無

描述：解鎖

訪問庫：是

eg：svn unlock somefile

 

svn update [PATH...]

別名：up

描述：更新WC，更新反饋有如下幾種分類。

        A  新增

B  鎖破壞

D  刪除

U  更新

C  衝突

G  合并

E  存在的

訪問庫：是

eg：svn up -r22   ##更新到一個指定版本

 

ps:如何去除SVN中儲存的使用者授權密碼

在Subversion安裝目錄下找到auth/svn.simple目錄，將下面的檔案刪除即可。

如果在烏龜中，可以setting->saved data->Authentication Data   點 clear 即可。

 

參考資料：http://svnbook.red-bean.com/en/1.5/svn.ref.svn.c.checkout.html

 

 

 

svn命令列使用說明
====================



0、查看協助

命令：   svn help



1、同步(checkout)伺服器資料到本地

命令：   svn checkout <url> [directory]
        svn co <url> [directory]

例：把 https://svn.test.cn/book/network/ 目錄同步到本地的 /usr/local/svn/book/network 目錄

# cd /usr/local/svn/book
# svn checkout https://svn.test.cn/book/network/
...
(R)eject, accept (t)emporarily or accept (p)ermanently? t
...
Password for ‘wandering‘: <斷行符號>   # wandering是我當前登入系統的帳號
Authentication realm: <https://svn.test.cn:443> book Subversion Repository
Username: jack
Password for ‘jack‘: <password>
...



2、提交(commit)本地文檔到伺服器

命令：   svn commit -m "" [directory|file]
        svn ci -m "" [directory|file]

例：把 /usr/local/svn/book/network/tcpip.txt 提交到伺服器，前提是伺服器上已經有此檔案。

# cd /usr/local/svn/book/network/
# svn commit -m ""  # -m是記錄的log資訊，可以為空白

一般情況下，只要在需要更新的資料檔案所在的目錄執行 svn ci -m "" 即可。



3、更新(update)伺服器資料到本地

命令：   svn update [directory|file]
        svn up [directory|file]

例：把 https://svn.test.cn/book/network/ 目錄中的內容更新到本地

# cd /usr/local/svn/book/network
# cd update



4、查看日誌

命令：   svn log [directory|file]

例：查看 /usr/local/svn/book/network 目錄的修改日誌

方法一：

# cd /usr/local/svn/book/network
# svn log

方法二：

# svn log /usr/local/svn/book/network



5、增加(add)本機資料到伺服器

命令：   svn add <directory|file>

svn 命令列基本操作