Subversion使用指南(已更新公司最新模板)

1、Subversion使用指南使用指南秘密課程學(xué)習(xí)目標(biāo)課程學(xué)習(xí)目標(biāo)n 了解了解Subvertion的基本概念和操作的基本概念和操作 秘密課程大綱課程大綱Subversion簡(jiǎn)介Subversion安裝Subversion配置Subversion操作常見問題秘密SubversionnSubversion （簡(jiǎn)稱為SVN）是一個(gè)自由/開源的版本控制系統(tǒng)，它系統(tǒng)地管理著文件和目錄nSubversion可以通過網(wǎng)絡(luò)訪問它的版本庫，從而使用戶可以在不同的終端上使用秘密TortoiseSVNnTortoiseSVN（簡(jiǎn)稱為TSVN）是 Subversion的 Windows 擴(kuò)展nTSVN嵌入 Window

2、s Explorer，可以實(shí)現(xiàn)簡(jiǎn)單的圖形化界面操作秘密課程大綱課程大綱Subversion簡(jiǎn)介Subversion安裝Subversion配置Subversion操作常見問題Subversion安裝秘密TSVN安裝n客戶端只需要安裝TSVN即可操作SubversionnTSVN安裝文件為：scm-svnSVNsetupTortoiseSVN-1.5.4.14259-win32-svn-1.5.3.msi 配套中文補(bǔ)丁為：scm-svnSVNsetupLanguagePack_1.5.4.14259-win32-zh_CN.msin以TortoiseSVN1.4.8版本為例圖示安裝步驟：秘密TS

3、VN安裝步驟-1運(yùn)行安裝文件，Next繼續(xù)秘密TSVN安裝步驟-2選擇“I accept ” ， Next繼續(xù)秘密TSVN安裝步驟-3缺省設(shè)置，可修改安裝路徑，Next繼續(xù)秘密TSVN安裝步驟-4Install開始安裝秘密TSVN安裝步驟-5安裝完成，F(xiàn)inish后重啟計(jì)算機(jī)。秘密TSVN安裝步驟-6安裝中文補(bǔ)丁，Install進(jìn)行安裝。秘密課程大綱課程大綱Subversion簡(jiǎn)介Subversion安裝Subversion配置Subversion操作常見問題Subversion配置秘密TSVN配置-1n右擊桌面選擇TortoiseSVN Settings，常規(guī)設(shè)置的語言欄選擇“中文(簡(jiǎn)體)”

4、n選中“將文件日期設(shè)置為“最后提交時(shí)間”，以便在做檢出或更新操作時(shí)，系統(tǒng)默認(rèn)將文件日期設(shè)置為庫中的最后提交時(shí)間，否則使用當(dāng)前日期n“全局忽略樣式”內(nèi)填入*.db *.bak *.obj等過程文件類型，以后每次進(jìn)行SVN操作，對(duì)擴(kuò)展名為.db、.bak和.obj等文件就是透明的了，不會(huì)對(duì)其做任何操作。多個(gè)擴(kuò)展名用空格隔開秘密TSVN配置-2秘密課程大綱課程大綱Subversion簡(jiǎn)介Subversion安裝Subversion配置Subversion操作常見問題Subversion操作Subversion簡(jiǎn)介秘密TSVN操作n工作副本的建立（檢出）n修改n提交n回退修改n新增n刪除n重命名n查看

5、文件狀態(tài)n顯示日志n文件差異比較n更新與同步n分支歸并n沖突解決n導(dǎo)出特定版本進(jìn)行構(gòu)建秘密工作副本的建立-1：工作副本n工作副本：相當(dāng)于CC中的一個(gè)靜態(tài)視圖，是私有工作區(qū)目錄，可以用 Windows Explorer來查看n每個(gè)目錄下都有一個(gè) .svn 的隱藏目錄，這個(gè)目錄存放了 SVN的一些控制信息注意：不要手工修改或刪除注意：不要手工修改或刪除 .svn隱藏目錄，否則會(huì)隱藏目錄，否則會(huì)導(dǎo)致工作副本被破壞！導(dǎo)致工作副本被破壞！nSVN中的檢出是指建立一個(gè)工作副本，不是CC中的checkout，且無需進(jìn)行類似CC的checkout操作秘密工作副本的建立-2：瀏覽版本庫n瀏覽版本庫以確定訪問路徑

6、，桌面右鍵單擊，如圖：n在URL框中輸入培訓(xùn)用版本庫的地址：svn:/scm-bak/SCMTrain注意：SVN區(qū)分字母大小寫！工作版本庫地址為各項(xiàng)目配置人員提供秘密工作副本的建立-3：瀏覽版本庫輸入地址后遠(yuǎn)程服務(wù)器要求驗(yàn)證，輸入有權(quán)限的用戶名和密碼l如果不想今后重復(fù)輸入，可以選上 “保存認(rèn)證”（Save authentication），那么今后本機(jī)訪問這個(gè)版本庫，除非是用戶密碼失效或更改，都不用再輸入l為安全考慮，建議只在自己的常用機(jī)器上點(diǎn)選 “保存認(rèn)證”秘密工作副本的建立-4：瀏覽版本庫輸入用戶和密碼后，看到整個(gè)項(xiàng)目版本庫秘密工作副本的建立-5：檢出在Windows資源管理器里選擇一個(gè)事

7、先建好的存放工作副本的目錄，右鍵單擊，選擇“SVN 檢出”（“SVN Checkout”）：秘密工作副本的建立-6：檢出可直接輸入需檢出文件夾的路徑，也可以通過瀏覽按鈕選擇，如圖：秘密工作副本的建立-7：檢出輸入地址后，遠(yuǎn)程服務(wù)器要求驗(yàn)證。驗(yàn)證成功后，項(xiàng)目文件從遠(yuǎn)程服務(wù)器下載到本地工作副本：秘密圖標(biāo)說明秘密修改n文件被檢出到工作副本后，可以直接使用編輯工具進(jìn)行修改，修改完成后請(qǐng)保存n完成“提交”（commit）操作后才真正將其放入版本庫！秘密提交-1n當(dāng)工作副本下文件內(nèi)容被添加，刪除，重命名，移動(dòng)等操作后，工作副本的圖標(biāo)會(huì)變成帶有“！”的標(biāo)識(shí) n選擇“SVN提交”秘密提交-2n彈出文件提交對(duì)話

8、框，在“信息”中添加相關(guān)注釋信息。要求填寫本次提交的修改內(nèi)容、原因及對(duì)應(yīng)CQ的變更的變更idn多個(gè)文件提交時(shí)，應(yīng)注意勾選變更列表中相關(guān)文件秘密回退修改n想要撤消一個(gè)文件自上次更新后的變更，相當(dāng)于CC的undo checkout，右鍵單擊，如圖：n只有還沒有“提交提交”的操作才可以回退！秘密新增-1n即在版本庫中新增文件或目錄，請(qǐng)謹(jǐn)慎！即在版本庫中新增文件或目錄，請(qǐng)謹(jǐn)慎！n將新增的內(nèi)容拷貝到工作副本中正確位置，右鍵單擊，選擇TSVN 增加（Add）秘密新增-2n如果是添加目錄的話，可以選擇添加目錄下的文件：n完成“提交”操作后才真正將其放入版本庫！秘密刪除n即刪除版本庫中文件或目錄，請(qǐng)謹(jǐn)慎！即刪

9、除版本庫中文件或目錄，請(qǐng)謹(jǐn)慎！n在工作副本目錄中選擇待刪除的文件，右鍵單擊，選擇TSVN 刪除（Delete）n不能直接使用Windows的delete命令！那樣只是本地暫時(shí)刪除，在更新工作副本后，刪除的文件又會(huì)出現(xiàn)n完成“提交”操作后才真正生效！秘密重命名n在工作副本目錄中選擇要改名的文件，右鍵單擊，選擇TSVN 改名（Rename）n不能直接使用Windows的重命名命令！n完成“提交”操作后才真正生效！秘密檢查更新-1如果要查看自上次提交以來有哪些文件有變化，在目錄上右鍵單擊， 選擇TSVN 檢查更新（Check for modifications）秘密檢查更新-2彈出的對(duì)話框顯示了工作

10、副本中做了修改的文件，也包括了當(dāng)前存在的未受控的新文件秘密顯示日志-1右擊，選擇TSVN 顯示日志（Show log）： 秘密顯示日志-2n選中某個(gè)版本會(huì)，會(huì)顯示對(duì)應(yīng)日志的具體內(nèi)容n右鍵單擊日志中某一版本可進(jìn)行的一些操作：秘密文件差異比較-1：四種方式n本地更改和服務(wù)器比較n與其他分支/標(biāo)簽的比較n兩個(gè)歷史版本的比較n不同文件的比較 秘密文件差異比較-2：本地更改和服務(wù)器比較n用于在未提交時(shí)，查看工作副本中的某文件有哪些更改n對(duì)文件右鍵單擊，TSVN 比較差異（Diff）：秘密文件差異比較-3：本地更改和服務(wù)器比較本地更改比較結(jié)果：秘密文件差異比較-4：與其他分支/標(biāo)簽的比較n用于比較同一文件

11、兩分支/標(biāo)簽間的區(qū)別n在右鍵單擊文件的同時(shí)按住Shift鍵，TSVN 以URL比較（Diff with URL） 選擇比較對(duì)象(分支/標(biāo)簽)：秘密文件差異比較-5：兩個(gè)歷史版本的比較n用于查看任意已提交的兩個(gè)歷史版本之間的差異n在版本日志對(duì)話框中選擇要比較的兩個(gè)版本，然后在右鍵菜單中選“比較版本差異”：秘密文件差異比較-6：不同文件的比較 n用于查看兩個(gè)不同文件之間的差異n在資源管理器中選擇這兩個(gè)文件，右鍵單擊，TSVN 比較差異（Diff）：秘密更新與同步-1n定期從服務(wù)器上獲取改動(dòng)到本地工作副本n更新至最新版本：SVN更新（SVN Update）秘密更新與同步-2n查看以前的版本，可選擇T

12、SVN 更新至版本（Update to revision）：秘密分支歸并-1：兩種方式n合并指定版本范圍 這個(gè)方法是指在一個(gè)分支(或者最新版本)上做了一個(gè)或多個(gè)修改，想將部分(或全部) 修改應(yīng)用到其他分支上n合并兩個(gè)不同的目錄樹這個(gè)方法應(yīng)用于例如新特性分支上的修改完成后，要將所有修改合并到主干最新版本，以保證主干最新版本和新特性分支同步秘密分支歸并-2對(duì)接受歸并的分支的工作副本的文件或目錄，右鍵單擊，選擇TSVN 合并（Merge）秘密分支歸并-3：合并指定版本范圍 n起始框：輸入源分支的文件路徑和開始版本號(hào)（要合并的修改之前修改之前的版本號(hào) ）n結(jié)束框：結(jié)束版本號(hào)（要合并的最后一個(gè)版本號(hào)，通

13、常是最新版本 ）此對(duì)話框的含義是，把起始框指定的51版本到結(jié)束框指定的53版本之間的差異（52、53）合并到工作副本秘密分支歸并-4：選擇版本范圍n選擇版本范圍最簡(jiǎn)單的方法是：l點(diǎn)擊顯示日志，列出最近的修改和日志l如果要合并單個(gè)版本的修改，直接選取那個(gè)版本l如果要合并多個(gè)版本，就選擇范圍(Shift鍵)l點(diǎn)擊確認(rèn)后，會(huì)自動(dòng)填寫合并對(duì)話框的開始版本號(hào)和結(jié)束版本號(hào)。秘密分支歸并-5：合并兩個(gè)不同的目錄樹 n起始框：輸入接受修改的分支的文件路徑，開始版本號(hào)是最新版本n結(jié)束框：輸入源分支的文件路徑，結(jié)束版本號(hào)是最新版本在歸并之前，最好先做預(yù)檢和比較差異，以保證歸并正確！秘密分支歸并-6：預(yù)檢 在合并操

14、作之前，預(yù)覽（Dry run）工作副本的修改效果：秘密分支歸并-7：比較差異 在合并操作之前，比較（Diff）待歸并節(jié)點(diǎn)間的差異： 秘密沖突解決-1nSVN使用 拷貝拷貝-修改修改-合并合并 模型n有沖突的工作空間會(huì)在本地工作副本中存在這些文件，例如：readme.txt.mine：本地新修改的文件readme.txt.r23：在做修改之前所檢出的文件readme.txt.r25：當(dāng)前版本庫中的最新版本秘密沖突解決-2n對(duì)沖突文件右鍵單擊，TSVN 編輯-沖突 ，解決沖突部分：秘密沖突解決-3n解決了沖突后，消除文件沖突標(biāo)記 TSVN 已解決n確定后，文件的圖標(biāo)顯示改成提交圖標(biāo)：秘密導(dǎo)出特定版

15、本進(jìn)行構(gòu)建-1n導(dǎo)出的文件不帶svn的圖標(biāo)標(biāo)記，也沒有.svn隱藏目錄，為干凈的目錄樹，便于版本構(gòu)建n如果要導(dǎo)出當(dāng)前工作副本中的文件，對(duì)要導(dǎo)出的文件，右鍵單擊，選擇TSVN 導(dǎo)出（Export）：秘密導(dǎo)出特定版本進(jìn)行構(gòu)建-2選擇導(dǎo)出到指定路徑：秘密導(dǎo)出特定版本進(jìn)行構(gòu)建-3如果要導(dǎo)出服務(wù)器上的某個(gè)目錄的最新版本，任意右擊，選擇TSVN 導(dǎo)出（Export）：秘密導(dǎo)出特定版本進(jìn)行構(gòu)建-4導(dǎo)出到指定路徑：秘密正式SVN庫的目錄結(jié)構(gòu)n代碼目錄lMain ：主分支，修改分支lBranch：其他分支，修改分支lTag：標(biāo)簽，同CC中的按標(biāo)簽取版本，不能修改n文檔目錄秘密課程大綱課程大綱Subversion

16、安裝Subversion配置Subversion操作Subversion簡(jiǎn)介常見問題秘密創(chuàng)建工作副本報(bào)錯(cuò)n創(chuàng)建工作副本報(bào)錯(cuò)：REPORT request failed on.Could not read chunk delimitern解決辦法：更新工作副本秘密TSVN安裝后資源管理器變慢-1n原因：TSVN安裝后，“TSVNCache.exe”這個(gè)進(jìn)程會(huì)掃描磁盤，簡(jiǎn)單來說工作副本中的文件有變化，綠色對(duì)勾圖標(biāo)變?yōu)榧t色感嘆號(hào)，就是通過這個(gè)進(jìn)程實(shí)現(xiàn)的。TSVN的掃描有時(shí)會(huì)和其他同樣掃描磁盤的軟件沖突，如ACDSEEn解決辦法：1.由于SVN采用域的認(rèn)證方式，所以首先要保持本機(jī)和域控之間的連通，配置

17、好網(wǎng)絡(luò)連接秘密65TSVN安裝后資源管理器變慢-2n解決辦法：2.TSVN 設(shè)置，如圖設(shè)置表示“TSVNCache.exe”進(jìn)程僅在包含路徑中指定的工作副本上進(jìn)行掃描，顯示圖標(biāo)“” 表示指定路徑包含的所有文件和文件夾 排除所有驅(qū)動(dòng)器排除所有驅(qū)動(dòng)器 包含包含所有所有工作副本工作副本 秘密TSVN安裝后資源管理器變慢-3n解決辦法：3.如果1、2不能解決問題，可將“狀態(tài)緩存”設(shè)置為“無”，但代價(jià)是TSVN不進(jìn)行監(jiān)控，工作副本沒有圖標(biāo)提示，只能通過TSVN 檢查更新，來檢查工作副本和服務(wù)器版本庫之間的變化秘密提交報(bào)錯(cuò)：423 locked-1n原因：該文件被鎖秘密提交報(bào)錯(cuò)：423 locked-2n

18、解決辦法：1.在版本瀏覽庫上找到該文件,右鍵 破除鎖定, 再做提交操作即可2.如果想檢查目錄下所有被鎖文件，可以對(duì)目錄右鍵，檢查更新 檢查版本庫，會(huì)顯示出鎖定的文件信息，然后右鍵選擇 破除鎖定：秘密提交報(bào)錯(cuò)：MKACTIVITY,and 403 Forbiddenn原因：SVN 在 Check out 等操作時(shí)，是URL大小寫不敏感的，可在 Commit、delete 時(shí)卻是大小寫敏感的，所以在設(shè)定SVN的服務(wù)器路徑時(shí)，一定要注意大小寫；也就是說檢出時(shí)最好選擇版本庫目錄，而不是手工敲，很容易產(chǎn)生大小寫問題n解決辦法：重新建工作副本，在Check out時(shí)，選用大小寫正確的URL版本庫目錄秘密提

19、交報(bào)錯(cuò)：CHECKOUT,and 403 Forbiddenn原因：修改的所在分支沒有修改權(quán)限n解決辦法：請(qǐng)?jiān)趧?chuàng)建工作副本時(shí)注意選擇正確的分支秘密提交報(bào)錯(cuò)：file or directory out-of-daten原因：文件或目錄過期，即本地工作副本自上次更新之后，版本服務(wù)器端已有其他更新，通常出現(xiàn)在多人修改同一文件的情況下n解決辦法：更新工作副本！更新后，如果無沖突，SVN自動(dòng)合并工作副本和服務(wù)器的更新；如有沖突則需手工解決沖突秘密如何修改svn文件/目錄的大小寫n使用版本庫的瀏覽器重命名該文件的大寫/小寫為小寫/大寫，更改完成后更新工作副本n如果在工作副本中修改會(huì)報(bào)錯(cuò)秘密如何找回誤操作的文件或目錄-1n在工作副本上，找到誤操作文件的所在目錄上，TSVN 顯示日志 ，找到誤操作的那條日志 ，右鍵單擊選擇 “復(fù)原此版本中的變更” 或 “復(fù)原到此版本”，相關(guān)選擇項(xiàng)的含義如下：l更新項(xiàng)目至版本：更新選中版本到工作副本，僅是更新到本地