創建版本

版本庫相當於一個集中的空間，用於存放開發者所有的工作成果。版本庫不僅能存放文件，還包括了每次修改的歷史，即每個文件的變動歷史。

Create 操作是用來創建一個新的版本庫。大多數情況下這個操作只會執行一次。當你創建一個新的版本庫的時候，你的版本控制系統會讓你提供一些信息來標識版本庫，例如創建的位置和版本庫的名字。

svnadmin create /pathto/repository

這裏有詳細的說明

檢出操作

Checkout 操作是用來從版本庫創建一個工作副本。工作副本是開發者私人的工作空間，可以進行內容的修改，然後提交到版本庫中。

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前是兩個短線，不是一個。
　　 不指定本地目錄全路徑，則檢出到當前目錄下。

檢出用戶權限之內的倉庫到當前目錄

D:\SRC\SVNdemo                                               
λ svn checkout svn://192.168.56.101/whoami --username=iamwho 
Checked out revision 0.                                      
                                                             
D:\SRC\SVNdemo                                               
λ ls                                                         
whoami/                                                      
                                                 
D:\SRC\SVNdemo                                               
λ ls -a whoami\                                              
./  ../  .svn/                                               
 

如果是第一進行需要進行認證

λ svn checkout svn://192.168.56.101/whoami --username=iamwho
Authentication realm: <svn://192.168.56.101:3690> c25526d4-9179-46e8-b951-a0ee69630537
Password for 'iamwho': ******
Checked out revision 0.

也可以使用TortoiseSVN進行可視化操作。

導出文件

幹凈模式

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文件夾裏沒有與之相關的信息記錄)的文件不會拷貝。

切換URL

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

導入文件

svn import [PATH] URL

例子：
svn import /home/testtools svn://localhost/test/testapp --username=user0

將未版本化的文件或樹提交到存儲庫中。

查看相關

目錄結構

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

文件信息

svn　info　文件名
例子：
svn info test.php

文件內容

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

文件日誌

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

文件狀態

使用svn status查看當前狀態，其格式

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

命令幫助

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

文件差異

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

提交更改

Commit 操作是用來將更改從工作副本到版本庫。這個操作會修改版本庫的內容，其它開發者可以通過更新他們的工作副本來查看這些修改。

在提交之前，你必須將文件/目錄添加到待變更列表中。列表中記錄了將會被提交的改動。當提交的時候，我們通常會提供一個註釋來說明為什麽會進行這些改動。這個註釋也會成為版本庫歷史記錄的一部分。Commit 是一個原子操作，也就是說要麽完全提交成功，要麽失敗回滾。用戶不會看到成功提交一半的情況。例如在當前目錄中添加一個Python文件，文件的圖標會出現一個符號

以下是在Cmder中的操作

可以看到Cmder似乎支持(用白色小括號顯示當前發生了更改)顯示svn status，並且當前目錄中有一個預定加入到版本庫的文件。

添加文件

使用svn add和svn commit，其一般格式如下

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 add返回svn status的狀態值，並且小括號變成紅色。

提交文件

提交後svn status值為空並且小括號顏色變回白色。

添加目錄

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　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開關

Tortoise圖標

使用TortoiseSVN通常圖標會發生一定的變化如下

其中一個文件帶著綠色小勾的是已經存在於版本庫之中的文件，而本來應該帶著問號的toDemo.py是未在版本庫之中的。當前添加toDemo.py後又發生如下變化：

可以看到文件圖標上添加了一個藍色加號，繼續提交後

可以看到文件圖標加號變成了綠色小勾了。

通常TortoiseSVN的圖標變化如下:

這是一些常用的，個別可以在 setting --> icon set 中查看

刪除文件

其格式一般如下

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”

刪除toDemo.py文件

可以看到文件狀態變成D了，繼續提交

加鎖解鎖

鎖定工作拷貝中文件，避免其他用戶修改導致沖突。

svn　lock　-m　“加鎖備註信息文本“　[--force]　文件名 
svn　unlock　文件名
例子：
svn lock -m “鎖信測試用test.php文件“ test.php 
svn unlock test.php

更新版本

顧名思義，update 操作是用來更新版本庫的。這個操作將工作副本與版本庫進行同步。由於版本庫是由整個團隊共用的，當其他人提交了他們的改動之後，你的工作副本就會過期。

讓我們假設 Tom 和 Jerry 是一個項目的兩個開發者。他們同時從版本庫中檢出了最新的版本並開始工作。此時，工作副本是與版本庫完全同步的。然後，Jerry 很高效的完成了他的工作並提交了更改到版本庫中。

此時 Tom 的工作副本就過期了。更新操作將會從版本庫中拉取 Jerry 的最新改動並將 Tom 的工作副本進行更新。

更新格式

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。

• 在A端修改文件toTest.py，然後執行提交

  D:\SRC\SVNdemo\iamwho ()
  λ svn status
  M       toTest.py

  D:\SRC\SVNdemo\iamwho ()
  λ svn commit -m "modify the file"
  Sending        toTest.py
  Transmitting file data .done
  Committing transaction...
  Committed revision 4.

• 在B端進行更新

  D:\SRC\SVNdemo\whoami ()  
  λ svn update toTest.py    
  Updating 'toTest.py':     
  U    toTest.py            
  Updated to revision 4.    
                            
  D:\SRC\SVNdemo\whoami ()  
  λ cat toTest.py           
  # encoding:utf-8          
       
  print("Hello SVN!")       

修復錯誤

我們來假設你對工作副本做了許多修改，但是現在你不想要這些修改了，這時候 revert 操作將會幫助你。

Revert 操作重置了對工作副本的修改。它可以重置一個或多個文件/目錄。當然它也可以重置整個工作副本。在這種情況下，revert 操作將會銷毀待變更列表並將工作副本恢復到原始狀態。

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

復制分支

完整復制

svn copy URL URL
例子：
svn copy file:///home/c7mon/svn/cellsms/trunk/wwm file:///home/c7mon/svn/cellsms/trunk/tags/wwm_1.0 -m "it's the wwm_1.0 foranhui" 。

完全的服務器端拷貝，通常用在分支和標簽。 如wwm項目完成後發布版本wwm_1.0

合並分支

svn 中並無特別的分支操作，可以用copy 或者 checkout一個版本進行操作，主要的是合並操作merge

svn merge SOURCE[@REV] [TARGET_WCPATH]
svn merge [-c M[,N...] | -r N:M ...] SOURCE[@REV] [TARGET_WCPATH]
svn merge SOURCE1[@REV1] SOURCE2[@REV2] [TARGET_WCPATH]

可以使用svn help merge查看具體操作

創建如下的兩個分支：

                                 ............
                                .            .
         trunk  --+------------L--------------R------
                   \                                               \                          |
                     \                         v
         feature      +------------------------o-----
                             r100            r200

D:\SRC\SVNdemo\iamwho ()
λ svn copy trunk/ branches/feature
A         branches\feature

查看狀態

D:\SRC\SVNdemo\iamwho ()
λ svn st
A  +    branches\feature

提交新增的分支到版本庫。

D:\SRC\SVNdemo\iamwho ()
λ svn commit -m "add feature"
Adding         branches\feature
Committing transaction...
Committed revision 8.

進入feature分支操作

D:\SRC\SVNdemo\iamwho\branches\feature (branches/feature) 
λ touch index.md                                          

D:\SRC\SVNdemo\iamwho\branches\feature (branches/feature) 
λ ls                                                      
HelloWorld.md  index.md  readme                           
                                                          
D:\SRC\SVNdemo\iamwho\branches\feature (branches/feature) 
λ svn add index.md                                        
A         index.md                                        
                                                          
D:\SRC\SVNdemo\iamwho\branches\feature (branches/feature) 
λ svn commit -m "add a index page"                        
Adding         index.md                                   
Transmitting file data .done                              
Committing transaction...                                 
Committed revision 11.                                               

切換到 trunk ，執行 svn update，然後將 feature 分支合並到 trunk 中。

$ svn merge ../branches/feature                               
--- Merging r9 through r12 into '.':                          
A    index.md                                                 
--- Recording mergeinfo for merge of r9 through r12 into '.': 
 U   .                                                        
                              
$ ls                                                          
HelloWorld.md  index.md  readme                               
                               
$ svn commit -m "add a index page"                            
Sending        .                                              
Adding         index.md                                       
Committing transaction...                                     
Committed revision 13.                                                                                                   

解決沖突

合並的時候可能會發生沖突。Merge 操作會自動處理可以安全合並的東西。其它的會被當做沖突。例如，"foo.c" 文件在一個分支上被修改，在另一個分支上被刪除了。這種情況就需要人為處理。Resolve 操作就是用來幫助用戶找出沖突並告訴版本庫如何處理這些沖突。

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除了刪除沖突文件，還修正了一些記錄在工作拷貝管理區域的記錄數據，所以我們推薦你使用這個命令。

標簽操作

版本管理系統支持 tag 選項，通過使用 tag 的概念，我們可以給某一個具體版本的代碼一個更加有意義的名字。

Tags 即標簽主要用於項目開發中的裏程碑，比如開發到一定階段可以單獨一個版本作為發布等，它往往代表一個可以固定的完整的版本，這跟 VSS 中的 Tag 大致相同。

在本地工作副本創建一個 tag。

λ svn checkout svn://192.168.56.101/whoami iamwho --username=iamwho
A    iamwho\branches                                               
A    iamwho\tags                                                   
A    iamwho\trunk                                                  
A    iamwho\toTest.py                                              
Checked out revision 5.   

D:\SRC\SVNdemo\iamwho ()
λ svn copy trunk\ tags\v1.0
A         tags\v1.0

上面的代碼成功完成，新的目錄將會被創建在 tags 目錄下。

D:\SRC\SVNdemo\iamwho ()
λ ls tagsv1.0/

D:\SRC\SVNdemo\iamwho ()
λ ls tags\v1.0HelloWorld.md  readme

查看狀態。

D:\SRC\SVNdemo\iamwho ()
λ svn status
A  +    tags\v1.0
A  +    tags\v1.0\HelloWorld.md
A  +    tags\v1.0\readme

提交tag內容。

D:\SRC\SVNdemo\iamwho ()
λ svn commit -m "tags v1.0"
Adding         tags\v1.0
Adding         tags\v1.0\HelloWorld.md
Adding         tags\v1.0\readme
Committing transaction...
Committed revision 7.

SVN基本命令