SVN客戶端用戶使用手冊（完整版）

SVN客戶端用戶使用手冊（完整版）
該文檔將逐步教您如何在軟件開發過程中使用svn客戶端
環境模擬
現有項目名稱：test
服務端版本庫：test
URL：http://10.155.11.10:81/svn
開發人員：devA，devB
版本庫目錄結構：

一．基本操作
第一步：安裝客戶端
到共享文件夾下，下載TortoiseSVN-1.4.0.7501-win32-svn-1.4.0.msi安裝程序，雙擊直接安裝即可。安裝成功後，右鍵單擊鼠標會多出兩個選項，分別是SVN checkout和Tortoise SVN。
第二步：建立工作區
項目開始之前，在本地PC的硬盤上，創建一個文件夾，文件夾命名隨意（例如workspace
），該文件夾即作爲軟件開發者在項目開發過程中的工作區。
第三步：下載版本庫
    假如現在開發一個項目，配置管理員會在服務端建立一個該項目的版本庫test
在workspace文件夾上，右鍵單擊鼠標。選擇SVN checkout，會出現如下窗口

在URL of repository中輸入版本庫地址，http://10.155.11.10:81/svn/test ，在Checkout dir中系統會自動添加第二步所創建的工作區目錄。Svn中文網
在Revision中，選中HEAD revision，這樣將會下載到版本庫的最新版本。如果想下載庫中的舊版本文件，可選中Revision，然後填入版本號即可。
如果不想下載整個版本庫，而是隻想下載自己負責的那部分模塊，可以在URL後添加模塊名，例如http://10.155.11.10:81/svn/test/Doc 。
單擊OK，輸入用戶名和密碼
第四步：修改版本庫
對版本庫的修改包括修改文件內容，添加刪除文件，添加刪除目錄。
經過第三步的操作，本地的工作區文件夾，即workspace上會有綠色對勾出現，工作區下的文件也會帶有綠色對勾，如圖2

如果對庫中某一個文件進行了修改，系統會自動爲這個文件和這個文件所在的各級父文件夾加上紅色歎號，代表該文件或目錄已經在本地被修改，如圖3

圖3
當所有對版本庫的修改操作完畢後，右鍵單擊工作區文件夾，選擇commit提交新版本，輸入密碼後系統將把修改後的版本庫上傳到服務端，即完成一次對版本庫的更新。
注意：
新版本提交之後，其他擁有寫權限的用戶也許會重複以上幾步的操作，完成對版本庫的再一次更新。所以，每次在工作區文件夾下修改本地版本庫之前，必須首先對本地版本庫執行一次更新（右鍵單擊工作區，選擇SVN Updata），將最新的版本下載到本地，然後再進行修改操作。

Svn中文網

二．其他操作
在日常的軟件開發過程中，除了以上介紹的下載，提交，更新操作外，還有另外幾種常用操作。
（1）比較文件的不同之處
當對soc_1做了修改之後，soc_1文件會出現紅色歎號，表示已經修改，如果想查看修改後的soc_1文件與修改前有何不同，可以右鍵單擊此文件，選擇diff，系統探出一個窗口，如圖3，窗口分爲兩個部分，左邊爲更改之前的版本，右邊爲更改之後的版本。並在不同之處作出標記和說明。如圖4

如果是word文檔的話，選擇diff之後，系統會打開一個word文檔，並在其中標出修改後的版本與修改前有何不同。如圖4.1

（2）查看日誌

如果想查看一個文件的日誌，例如soc_1，右鍵單擊這個文件，選擇show log，系統會踏出一個窗口，並在窗口中顯示soc_1各個版本的log。如圖4

圖5

（3）查看版本樹

如果想查看soc_1文件的版本樹，右鍵單擊該文件，選擇Revision graph，系統將會打開一個窗口，並在窗口中顯示該文件的版本樹。如圖6。

   之所以只顯示了4.5.6.7四個版本，是因爲選擇了只顯示發生過變化的版本。即1.4.5.6.7每一個版本都有不同的地方，都是經過用戶修改後提交的。而2.3兩個版本是與版本1相同的。

（4）下載某個文件的舊版本

如果想要得到某個文件的舊版本，只需在該文件上單擊右鍵，選擇Updata to revision…即可。系統會提示輸入版本號。例如要下載soc_1的第五個版本，只需填入5即可。如圖7。查看完版本5的文件後，如果想在此回到最新版本，只需要對soc_1運行Updata即可。

（5）重名名和刪除文件

如果要刪除一個文件或重名名一個文件，

注意不要在windows下直接操作。只需右鍵單擊該文件，選擇Rename或Delete，svn系統便會完成操作。

在workspace中將文件重命名或刪除後，服務端的文件結構不會變化，只有當提交新版本庫後，即commit後，服務端的文件結構纔會被更新。

如果誤刪除了文件，在沒有提交版本庫之前，可以通過對版本庫的升級將文件重新下載到本地的版本庫，也可以通過revert恢復（參考第八條）。如果文件刪除，並且已經提交，那麼要找回文件只能通過下載舊版本庫來完成，參考（4）。

（6）創建分支

版本庫中最初的文件soc_1,soc_2,word_1,word_2都是主幹文件。如果想要爲soc_1創建一個分支，只需右鍵單擊soc_1，選擇Branch/Tag，系統會彈出一個窗口，如圖8。在窗口中，From URL表示要創建的這個分支是soc_1的分支（系統會自動添加，不必更改）。在To URL中，需要更改一下文件名，在文件名後加一個標誌即可，例如“

Bbs.Svn8.Com

_branch”，路徑不需要更改。在Creat copy in the repository from中，可以選擇分支文件是由soc_1的那一個版本拷貝來的。最後填寫日誌，選擇OK。

分支創建完畢，Updata版本庫，系統會將soc_1的主幹文件和分支文件soc_1_branch同時下載到本地版本庫，如圖8.1，然後即可在分支文件上進行操作。此時soc_1的版本樹如圖8.2

（7）合併分支

當需要把soc_1_branc分支文件合併到soc_1主幹文件時，右鍵單擊soc_1，選擇Merge，會彈出一個窗口，如圖9。

在 From輸入框中填入主幹的URL，在To輸入框中填入分支的URL。在From和To中，都有兩個選項HEAD Revision和Revision，表示要進行合併的是soc_1的那個版本。合併之後主幹文件會標註紅色歎號，表示已被修改，並可以提交。如果合併後文件標註的是黃色歎號，表示文件有衝突，處理方法見第三部分“異常處理”。

（8）撤銷修改

當對一個文件進行了修改並保存後（注意此處並沒有進行提交），如果對修改不滿意，想要重新修改，可以右鍵單擊修改過的文件（帶紅色歎號的那個），然後選擇revert，前面的一系列修改便會被撤銷，恢復到Updata之後的狀態。如果一個文件被誤刪除，也可通過右鍵單擊該文件所在的目錄，選擇revert來恢復。

三．異常處理

此處所說的異常主要是指文件發生衝突。以用戶devA和用戶devB爲例，

當兩個用戶同時下載了最新的版本庫，並對庫中同一個文件soc_2進行修改提交時，首先提交的用戶devA不會發生異常，第二個提交的用戶

Www.Svn8.Com

devB便會出現無法提交的現象。因爲服務端的版本庫已經被devA更新，devB用戶在上傳時，系統會提示出錯如圖10。

在這種情況下，devB用戶需要首先對修改的文件進行Updata文件操作。如果兩個用戶修改了文件soc_2的同一個地方，則在devB用戶執行Updata後，系統會將本地的soc_2與從服務端下載soc_2合併到一個文件上，並在該文件圖標上標上黃色歎號，表示文件出衝突。在文件中通過“<<<<<<”和“>>>>>>”標識衝突位置和衝突內容。devB用戶只有與devA協商，將該衝突處理，之後單擊右鍵，選擇Resolve，衝突標記消除，才能夠再次提交，否則無法提交。

文件標記衝突的格式：

<<<<<<< .mine

    workspsace工作區，等abc工作區提交結束後再提交，應該會出現衝突
 

=======

   在此插入一段話，啊啊aaa，測試衝突

>>>>>>> .r15

綠色部分表示本地文件的修改

藍色部分表示服務端版本庫中的最新版本與本地文件修改發生衝突的地方。

紫色表示是第15個版本發生了衝突

=======

   在此插入一段話，啊啊aaa，測試衝突

>>>>>>> .r15

綠色部分表示本地文件的修改

藍色部分表示服務端版本庫中的最新版本與本地文件修改發生衝突的地方。

紫色表示是第15個版本發生了衝突