CVS使用手冊

作者： 車東 Email: chedongATbigfoot.com/chedongATchedong.com

寫於：2002/07/10 最後更新： <script language=Javascript src="http://www.chedong.com/referer.js"></script> 09/02/2004 16:00:58 Feed Back >> 

版權聲明：可以任意轉載，轉載時請務必以超鏈接形式標明文章原始出處和作者信息及本聲明
http://www.chedong.com/tech/cvs_card.html

關鍵詞：CVS CVSWeb CVSTrac WinCVS CVSROOT

內容摘要：

CVS是一個C/S系統，多個開發人員通過一箇中心版本控制系統來記錄文件版本，從而達到保證文件同步的目的。工作模式如下：

       CVS服務器（文件版本庫）
     /     |       /
     （版 本 同 步）
   /       |         /
開發者1  開發者2   開發者3

作爲一般開發人員挑選2,6看就可以了，CVS的管理員則更需要懂的更多一些，最後還簡單介紹了一些Windows下的cvs客戶端使用，CVS遠程用戶認證的選擇及與BUG跟蹤系統等開發環境的集成問題。

1. CVS環境初始化：CVS環境的搭建 管理員
2. CVS的日常使用：日常開發中最常用的CVS命令， 開發人員 管理員
3. CVS的分支開發：項目按照不同進度和目標併發進行 管理員
4. CVS的用戶認證：通過SSH的遠程用戶認證，安全，簡單 管理員
5. CVSWEB：CVS的WEB訪問界面大大提高代碼版本比較的效率 管理員
6. CVS TAG：將$Id$ 加入代碼註釋中，方便開發過程的跟蹤開發人員
7. CVS vs VSS: CVS和Virsual SourceSafe的比較 開發人員 管理員
8. WinCVS: 通過SSH認證的WinCVS認證設置
9. 基於CVSTrac的小組開發環境搭建：通過CVSTrac實現web界面的CVS用戶管理,集成的BUG跟蹤和WIKI交流
10. CVS中的用戶權限管理：基於系統用戶的CVS權限管理和基於CVSROOT/passwd的虛擬用戶管理
    

一個系統20%的功能往往能夠滿足80%的需求，CVS也不例外，以下是CVS最常用的功能，可能還不到它全部命令選項的20%，作爲一般開發人員平時會用cvs update和cvs commit就夠了，更多的需求在實際應用過程中自然會出現，不時回頭看看相關文檔經常有意外的收穫。

CVS環境初始化

環境設置：指定CVS庫的路徑CVSROOT

tcsh
setenv CVSROOT /path/to/cvsroot
bash
CVSROOT=/path/to/cvsroot ; export CVSROOT

後面還提到遠程CVS服務器的設置：
CVSROOT=:ext:[email protected]#port:/path/to/cvsroot CVS_RSH=ssh; export CVSROOT CVS_RSH

初始化：CVS版本庫的初始化。
cvs init

一個項目的首次導入
cvs import -m "write some comments here" project_name vendor_tag release_tag
執行後：會將所有源文件及目錄導入到/path/to/cvsroot/project_name目錄下
vender_tag: 開發商標記
release_tag: 版本發佈標記

項目導出：將代碼從CVS庫裏導出
cvs checkout project_name
cvs 將創建project_name目錄，並將最新版本的源代碼導出到相應目錄中。這個checkout和Virvual SourceSafe中的check out不是一個概念，相對於Virvual SourceSafe的check out是cvs update， check in是cvs commit。

CVS的日常使用

注意：第一次導出以後，就不是通過cvs checkout來同步文件了，而是要進入剛纔cvs checkout project_name導出的project_name目錄下進行具體文件的版本同步（添加，修改，刪除）操作。

將文件同步到最新的版本
cvs update
不制定文件名，cvs將同步所有子目錄下的文件，也可以制定某個文件名/目錄進行同步
cvs update file_name
最好每天開始工作前或將自己的工作導入到CVS庫裏前都要做一次，並養成“先同步 後修改”的習慣，和Virvual SourceSafe不同，CVS裏沒有文件鎖定的概念，所有的衝突是在commit之前解決，如果你修改過程中，有其他人修改並commit到了CVS 庫中，CVS會通知你文件衝突，並自動將衝突部分用
>>>>>>
content on cvs server
<<<<<<
content in your file
>>>>>>
標記出來，由你確認衝突內容的取捨。
版本衝突一般是在多個人修改一個文件造成的，但這種項目管理上的問題不應該指望由CVS來解決。

確認修改寫入到CVS庫裏
cvs commit -m "write some comments here" file_name

注意：CVS的很多動作都是通過cvs commit進行最後確認並修改的，最好每次只修改一個文件。在確認的前，還需要用戶填寫修改註釋，以幫助其他開發人員瞭解修改的原因。如果不用寫-m "comments"而直接確認`cvs commit file_name` 的話，cvs會自動調用系統缺省的文字編輯器(一般是vi)要求你寫入註釋。
註釋的質量很重要：所以不僅必須要寫，而且必須寫一些比較有意義的內容：以方便其他開發人員能夠很好的理解
不好的註釋，很難讓其他的開發人員快速的理解：比如： -m "bug fixed" 甚至 -m ""
好的註釋，甚至可以用中文: -m "在用戶註冊過程中加入了Email地址校驗"

修改某個版本註釋：每次只確認一個文件到CVS庫裏是一個很好的習慣，但難免有時候忘了指定文件名，把多個文件以同樣註釋commit到CVS庫裏了，以下命令可以允許你修改某個文件某個版本的註釋：
cvs admin -m 1.3:"write some comments here" file_name

添加文件
創建好新文件後，比如：touch new_file
cvs add new_file
注意：對於圖片，Word文檔等非純文本的項目，需要使用cvs add -kb選項按2進制文件方式導入(k表示擴展選項，b表示binary)，否則有可能出現文件被破壞的情況
比如：
cvs add -kb new_file.gif
cvs add -kb readme.doc

如果關鍵詞替換屬性在首次導入時設置錯了怎麼辦？
cvs admin -kkv new_file.css

然後確認修改並註釋
cvs ci -m "write some comments here"

刪除文件
將某個源文件物理刪除後，比如：rm file_name
cvs rm file_name
然後確認修改並註釋
cvs ci -m "write some comments here"
以上面前2步合併的方法爲：
cvs rm -f file_name
cvs ci -m "why delete file"
注意：很多cvs命令都有縮寫形式：commit=>ci; update=>up; checkout=>co/get; remove=>rm;

添加目錄
cvs add dir_name

查看修改歷史
cvs log file_name
cvs history file_name

查看當前文件不同版本的區別
cvs diff -r1.3 -r1.5 file_name
查看當前文件（可能已經修改了）和庫中相應文件的區別
cvs diff file_name
cvs的web界面提供了更方便的定位文件修改和比較版本區別的方法，具體安裝設置請看後面的cvsweb使用

正確的通過CVS恢復舊版本的方法：
如果用cvs update -r1.2 file.name
這個命令是給file.name加一個STICK TAG： "1.2" ，雖然你的本意只是想將它恢復到1.2版本
正確的恢復版本的方法是：cvs update -p -r1.2 file_name >file_name
如果不小心已經加成STICK TAG的話：用cvs update -A 解決

移動文件/文件重命名
cvs裏沒有cvs move或cvs rename，因爲這兩個操作是可以由先cvs remove old_file_name，然後cvs add new_file_name實現的。

刪除/移動目錄
最方便的方法是讓管理員直接移動，刪除CVSROOT裏相應目錄（因爲CVS一個項目下的子目錄都是獨立的，移動到$CVSROOT目錄下都可以作爲新的獨立項目：好比一顆樹，其實砍下任意一枝都能獨立存活），對目錄進行了修改後，要求其開發人員重新導出項目cvs checkout project_name 或者用cvs update -dP同步。

項目發佈導出不帶CVS目錄的源文件
做開發的時候你可能注意到了，每個開發目錄下，CVS都創建了一個CVS/目錄。裏面有文件用於記錄當前目錄和CVS庫之間的對應信息。但項目發佈的時候你一般不希望把文件目錄還帶着含有CVS信息的CVS目錄吧，這個一次性的導出過程使用cvs export命令，不過export只能針對一個TAG或者日期導出，比如：
cvs export -r release1 project_name
cvs export -D 20021023 project_name
cvs export -D now project_name

CVS Branch：項目多分支同步開發

確認版本里程碑：多個文件各自版本號不一樣，項目到一定階段，可以給所有文件統一指定一個階段里程碑版本號，方便以後按照這個階段里程碑版本號導出項目，同時也是項目的多個分支開發的基礎。

cvs tag release_1_0

開始一個新的里程碑：
cvs commit -r 2 標記所有文件開始進入2.x的開發

注意：CVS裏的revsion和軟件包的發佈版本可以沒有直接的關係。但所有文件使用和發佈版本一致的版本號比較有助於維護。

版本分支的建立
在開發項目的2.x版本的時候發現1.x有問題，但2.x又不敢用，則從先前標記的里程碑：release_1_0導出一個分支 release_1_0_patch
cvs rtag -b -r release_1_0 release_1_0_patch proj_dir