1、 目 錄第一章引言11.1Subversion的介紹11.2Subversion的特性11.3SVN鏈接模式21.4SVN操作流程3第二章SVN使用42.1SVN軟件安裝42.2事業部SVN庫介紹42.2.1事業部SVN庫42.2.2帳號注冊、權限申請52.3基本操作52.3.1操作介紹52.4系統規范使用182.4.1規范操作182.4.2版本控制的使用192.4.3與目錄無關內容192.4.4文件夾目錄名稱規范202.4.5文件上傳格式212.4.6文件、數據放置212.5日常使用問題212.5.1版本庫無響應212.5.2郵件中的路徑鏈接212.5.3系統庫最上層打不開222.5.4提交

2、失敗（Commit fail）222.5.5SVN文件夾無法下載232.5.6特征圖標的顯示232.5.7沖突問題解決24SVN使用規范第一章 引言1.1 Subversion的介紹SVN是Subversion的縮寫。Subversion管理隨時改動的文件和目錄，以二進制格式存儲所有的文件，使用高效的比較二進制差異算法來計算版本之間的改動。同時，它是一個時間機器，隨時記錄文件和目錄的每次改動，例如：文件的增加、刪除、重新排列文件等。同時SVN允許你恢復以前舊版本的數據，或者檢查數據變化的歷史。SVN使用類似數據庫事物的方式來處理用戶提交入庫的過程，整個改動要么成功的被提交，要么被中斷并回滾。在

3、數據提交完之前，其他人是看不到用戶提交的修改文件，你看到的要么是改動之前的狀態，要么是改動之后的狀態。這樣的行為被稱為“原子提交”。原子提交很有用，因為它能保證所有相關人員看到的總是相同的東西。原子提交過程的其中一步就是包括把你的所有改動打包為一個“修訂集”（有時被稱為改動集），并且再給個改動標記的修訂號（綠色勾變為紅色嘆號）。1.2 Subversion的特性1.2.1 版本化的目錄 Subversion實現了一個可以跟蹤目錄樹更改的“虛擬”版本化文件系統，文件和目錄都是有版本的。1.2.2 真實的版本歷史 通過Subversion你可以對文件或是目錄進行增加、拷貝和改名操作，也可以新增一個

4、具有干凈歷史的文件。可以毫不夸張的將每一個版本都可以作為一個記憶片段定點。1.2.3 原子提交版本庫采用二進制差異形式提交修改的數據內容，一系列的改動，要么全部提交到版本庫，要么一個也不提交，這樣可以讓用戶構建一個需要提交修改的邏輯塊，放置部分修改提交到版本庫。1.2.4 一致的數據操作Subversion表示文件是建立在二進制文件區別算法基礎上的，對于文本（可讀）和二進制（不可讀）文件具備一致的草所方式，兩種類型的文件都壓縮存放在版本庫中。1.3 SVN鏈接模式其中本地工作副本與SVN系統鏈接的媒介是“.svn”隱藏文件夾，.svn隱藏文件夾中包含了系統鏈接、版本等信息，圖1-1為本地工作副

5、本與SVN系統鏈接后狀態，綠色勾代表文件受系統控制（后面簡稱：受控）標志，紅色嘆號為受控文件改動標志。圖1-1 鏈接狀態1.4 SVN操作流程WorkingCopyWorkingCopyRepositoryNetwork版本庫網絡本地工作副本檢出、提交圖1-2 操作流程圖圖1-2總體概括了SVN整個操作過程：首先用戶從版本庫通過網絡“檢出”到本地工作副本中，然后，在本地工作副本中進行增加、修改、刪除文件后“提交”到版本庫中，如果本地工作副本中版本較系統版本過時，用戶使用“更新”功能與系統上版本保持一致。第二章 SVN使用2.1 SVN軟件安裝SVN的安裝軟件是公司受控軟件，用戶安裝需要由各單位

6、文員走軟件安裝的OA流程，在接到流程申請后電腦中心安排陽光服務安裝。如果SVN軟件在電腦重裝系統后被卸載掉，請用戶直接聯系電腦中心（內線：63333）處理。2.2 SVN庫介紹2.2.1 SVN庫2.2.2 操作介紹1. 系統登錄點擊鼠標右鍵出現功能選項，選擇“TortoiseSVN”中的“版本庫瀏覽器”，這時系統彈出URL界面，用戶在URL中輸入需要進入的庫路徑，彈出登錄認證框，用戶輸入用戶名和密碼進入系統主界面。 圖2-1(a) 系統登錄圖2-1(b) 認證界面圖2-1(c) public庫系統界面圖2-1（a）和圖2-1（b）是系統登錄操作界面，圖2-1（c）是系統的主界面，三副圖中整體

7、描述了SVN系統的登錄情況。注：圖2-1（b）中“Save authentication”是保存認證選項，用戶根據需要對自己的用戶名和密碼進行保存，以便在下次操作時不需要再次輸入用戶名和密碼了。2. 設置功能的使用在上節類容中主要講述了系統的登錄方式和認證保存的方法，接下來繼續講述系統“設置（Setting）”功能的使用。在設置中，用戶可以根據需要選擇系統的語言顯示、清除已保存的數據、顯示特征標志等等。（1） 系統語言顯示選擇圖2-2 系統語言中-英文轉換系統安裝后全部默認為英文模式，這時需要用戶手動切換到中文模式。圖2-2中描述了中英文切換的過程，在選擇“設置（Setting）”功能后彈出的

8、對話框自動顯示語言欄（Language），用戶選擇“中文（簡體）”后確認即可。（2） 忽略上傳文件SVN系統有一個似過濾器的功能，在本地工作副本中用戶可以根據需要過濾一些不需要上傳到服務器的文件，這個功能就是“全局忽略樣式”。圖2-3（a） 全局忽略樣式忽略樣式對提交文件擴展名進行選擇性忽略，忽略格式通常以*.X形式被系統識別，例如：用戶不需要將編譯產生的.o和.err文件提交到SVN上，這時用戶在全局忽略樣式中輸入*.o *.err如圖2-3（a），各條目之間以空格分隔。注意：當用戶在本地工作副本中對新添加文件采用了系統添加功能操作，忽略樣式功能對本地副本中的文件將不起作用，如圖2-3(b)

9、表藍色加號表示文件已添加；另外還有一種情況，如果已經將想忽略的文件提交到了SVN系統上，是無法進行忽略的。圖2-3（b） 添加文件樣式（3） 保存清除在對系統保存認證后相應需要對認證進行清除，清除功能仍然在設置模塊中，界面如圖2-4。在保存清除中共可以對本地四種已保存數據進行清除，分別有URL歷史記錄、日志信息、窗口大小、認證數據，在對這些數據完全清理后系統自動恢復到“零”狀態。因此，用戶在離機后也別忘記將保存認證數據清除掉，以保障資料的安全性。圖2-4(a) 認證清除圖2-4(b) 密碼清除（4） 特征標志選擇不少用戶在使用SVN“檢出”功能后，本地工作副本沒有出現特征符號綠色勾或其他特征符

10、號，這是由于系統無法識別默認的狀態緩存，需要人工手推選擇狀態緩存方式，改變狀態緩存方法如圖2-5，在設置中選擇“外觀與樣式”的“圖標疊加”模塊，再在“狀態緩存”中選擇“Windows外殼”。圖2-5 特征顯示設置中其他不常用的功能不再進行一一介紹，用戶可以根據日常操作實踐來理解。3. 在SVN系統上進行日常工作SVN系統不支持直接在系統上對文件修改的操作。如果有受控文件需要修改，用戶可以通過在本地工作副本中修改后提交到系統上，這中間的媒介就是.svn隱藏文件夾，系統的整個操作范圍：“檢出”“提交”“更新”，接下來給大家詳細介紹各操作。（1）本機文件夾與服務器文件夾之間的鏈接首先，在本地電腦新建

11、一個文件夾，并給文件夾重新命名；然后，鼠標選擇文件夾，點擊右鍵選擇“檢出（Checkout）”功能,使用檢出功能后本地文件夾有一個綠色的勾，稱之為本地“工作副本”。圖2-6（a）中黃色框為SVN路徑選擇區域，綠色框為本地路徑選擇區域，用戶根據需要在后面按鈕處選擇相關下載路徑。圖2-6（b）中為系統文件夾檢出到本地后的狀態。 圖2-6（a） SVN檢出按鈕圖2-6（b） SVN檢出視圖另外，用戶還可以在系統界面直接檢出需要文件夾到本地，在服務器界面選擇需要下載文件夾如圖2-6（c），然后點擊右鍵選擇“檢出”功能再繼續按照以上操作即可。注：用戶需要注意“檢出”功能只針對系統文件夾，對于系統中單個文

12、件是不能夠使用檢出的。圖2-6（c） 界面SVN檢出（2）日常操作上傳SVN當創建了本地工作副本后，可以在副本中進行任何日常操作，如：增加文件夾、文件、修改文件、數據等，用戶每天下班前將需要本地副本中做的修改提交（Commit）到SVN上，確保服務器上數據與本地副本中的數據保持同一版本。需要強調的是，雖然用戶在本地創建了工作副本，但如果所有執行操作沒有提交到SVN上，一旦本機數據丟失，將無法追溯。用戶在提交時需要注意兩點，如圖2-7： 選擇提交無版本控制選項，避免出現新增文件漏提現象； 日志備注的填寫，方便后續對文件的追溯。圖2-7 SVN提交（3）文件修改差異比較SVN系統有一個非常適用的功

13、能“修改差異的比較”，可以將本次修改內容和原稿作比較并顯示出來，圖2-8（a）為提交版本與修改前差異比較方法，圖2-8（b）為追溯歷史版本之間差異的比較方法。圖2-8（a） 修改差異比較圖2-8（b） 追溯差異比較1圖2-8（b） 追溯差異比較2（4）歷史追溯SVN系統的記憶猶如時間片段的集合，每一個版本代表了一個時間定點，當用戶需要回顧或追溯之前的某一個時間節點時，通過系統的日志顯示（show log）功能來實現。通俗一點講，十五部的SVN系統正是一部錄制過程中的電影，每一個用戶提交的內容都是勞動集成點的片段，當某一天用戶需要回憶某個記憶點時，可以結合圖2-9的操作來實現。在看圖2-9之前，

14、 先回到2-8（b）的過程中，選擇了顯示日志功能列表中有一個專用“瀏覽版本庫”功能，用戶通過這個功能可以回到之前任意一個版本時代。圖2-9 歷史記錄追溯（5）系統自帶的搜索功能SVN系統自帶強大的搜索功能，用戶可以通過選擇日志信息、路徑、作者、版本號查詢所需版本文件。具體操作步驟如下：第一步：選擇需要查找的目錄，右鍵選擇“顯示日志”功能，彈出圖2-10（a）界面。第二步：如果日志信息在100條以上，需要選擇左下角的“全部顯示”或“下100”按鈕。圖2-10（a）日志顯示 第三步：從對話框右上角的放大鏡窗口選擇需要搜索的信息，例如：需要查詢zhaoxizu提交的文件，在對話框中輸入zhaoxiz

15、u回車即可，如圖2-10（b）。圖2-10(b) 系統自帶搜索（6）SVN輔助功能使用SVN輔助系統主要應用于public、project、office三個庫中，功能主要包括用戶密碼的修改、使用記錄查詢、文件搜索三個模塊。 客戶端界面登錄用戶通過IE瀏覽器輸入路徑 :8080 進入圖2-11界面，然后輸入SVN用戶名和密碼登錄管理系統。圖2-11 輔助功能登錄界面 其他輔助功能的使用進入管理系統界面后，用戶根據需要來修改密碼和搜索文件等等。圖2-12 密碼修改2.3 系統規范使用SVN系統的日常使用一律按照SVN使用管理辦法執行。2.3.1 規范操作日常文件更新一律

16、按照“檢出提交”的方法，用戶需要在本地創建工作副本，在本地修改后提交到SVN系統上，不允許直接將文件拉到系統上，圖2-13中列舉用戶操作不規范現象。 2-13 使用不規范現象2.3.2 版本控制的使用文件的追溯性主要表現在文件的版本提交控制情況，一個文件或數據的成型可能經歷上百個版本修改。因此，只要使用好版本控制，不僅節省腦力勞動，而且提高了工作效率，當日文件修改后提交過程中日志備注是必不可少的。圖2-14 版本控制管理2.3.3 與目錄無關內容SVN系統平臺是事業部各人員日常工作平臺，提交的文件和數據均是工作相關內容，因此不允許用戶將私人照片、電影等不相關內容上傳。另外在project庫中研

17、發工程師需按照PQE項目質量擬定的基線目錄提交相關內容，圖2-15中列舉了M6車型中上傳F3項目的不規范現在。圖2-15 使用不規范目錄2.3.4 文件夾目錄名稱規范用戶在提交日常文件成功后，系統會自動精確到秒的記錄用戶所有操作，因此，用戶在日志備注中注明提交原因和較詳細的描述修改的地方，不需要在文件夾名后添加文件修改日期，圖2-16中形象的表現了用戶在文件夾后加日期不規范現象。圖2-16 文件夾帶日期不規范現象2.3.5 文件上傳格式日常更新的文件、數據不能轉換成PDF、壓縮包等格式提交；文件不用壓縮，不能設置密碼。2.3.6 文件、數據放置 文件、數據不允許重復放置。2.4 日常使用問題2

18、.4.1 版本庫無響應在版本庫瀏覽器中輸入SVN路徑后系統處于無響應狀態。解決方法：檢查SVN路徑是否輸入正確，如果正確，請用戶確認路徑和符號是否在英文模式下輸入的，如果不是請將其修改為英文模式。導致原因：由于SVN現階段只支持全英文狀態路徑，因此用戶在輸入路徑時要注意。2.4.2 郵件中的路徑鏈接直接點擊郵件中的鏈接地址為何打不開文件？導致原因：輸入路徑太長，OE（Outlook Express）中只默認到一定字節數，導致點擊鏈接文件無法達到底層目錄或直接發生鏈接錯誤。解決方法：在OE中選擇“插入”“超級鏈接”“URL”，將全部路徑粘貼進URL中，接收方在點擊鏈接后能順利打開文件。如圖2-1

19、7：圖2-17 outlook路徑輸入模式2.4.3 系統庫最上層打不開導致原因： 網絡不通； 使用IE代理； 路徑輸入錯誤.問題解析：用戶要清楚一點，所有系統帳號，最上層是一定能打開的，除非你沒有SVN帳號。一旦發現上述情況，用戶首先是檢查路徑的正確性。如果路徑正確，請確認是否存是由以下兩種因素引起的。（1）首先，請檢查網絡是否連通；（2）其次，檢查是否使用了網絡代理，由于Apache關系，用戶在使用代理后是無法登錄SVN的。2.4.4 提交失敗（Commit fail）（1） 文件提交不上圖2-18 文件無法提交導致原因：綠框內記錄了問題點存在的直接原因，當用戶提交文件時，系統提示路徑不存

20、在，該路徑指代的是系統上與本地鏈接的路徑已經不存在。此時，用戶首先確認是否對服務器上相應目錄名稱做過改動，或者是將該目錄移植、刪除。（2）沒有權限看到報錯信息中包含以上信息（Commit fail）時，請聯系SVN管理員處理權限配置。2.4.5 SVN文件夾無法下載如果一個文件夾內容的無法下載，導致原因有兩種：（1）文件名末尾有空格解決方法：將文件名稱的空格去除，再執行下載操作。（2）本地目錄中已下載相同路徑（如以下圖片）在本機中已存在“.svn”路徑的目錄下繼續下載第二個目錄是不可執行的操作，如圖2-19。解決方法：如果真需要繼續在本目錄中下載其他文件夾，用戶在該目錄下新建一個文件夾后再執行檢出操作，以新建目錄為本地副本。圖2-19 目錄無法下載2.4.6 特征圖標的顯示明明是檢出了，受控文件（夾）為何沒有綠色勾？導致原因：由于個別電腦無法識別SVN默認選擇的Default，因此電腦在檢出后沒有綠色勾特征。解決方法：在設置中的Icon Overlays 中選擇