CVS

代码配置

个人开发者希望一个版本控制系统的安全网络能够运行在他们的本地的一台机器上。然而，开发团队需要一个集中的服务器，所有的成员可以将服务器作为仓库来访问他们的代码。在一个办公室中，没有问题 --只是将仓库连到本地网络上的一台服务器上就行了。对于开放源码项目…噢， 还是没有问题，这要感谢因特网。CVS内建了客户机/服务器存取方法，所以任何一个可以连到因特网上的开发者都可以存取在一台CVS服务器上的文件。n

代码调整

在传统的版本控制系统中，一个开发者检出一个文件，修改它，然后将其登记回去。检出文件的开发者拥有对这个文件修改的排它权。没有其它的开发者可以检出这个文件-- 并且只有检出那个文件的开发者可以登记(check in：注2)所做的修改。(当然对于管理员有很多方法可以超越这个限制。)n想一下排它的检出可能会如何工作：Bob的兄弟检出 foo.java以便加入注释，写好代码后他什么也没做。然后他去吃午饭了。Bob吃完午饭后，发现他的老板所指给他的一个bug在 foo.java里。他试图签出 foo.java … 但是版本控制系统不允许他这样做，因为他的兄弟已经把它签出了。Bob不得不等着他的兄弟吃完午饭回来(在这个"好"日子用了两个小时)，他才可以修正bug。n在一个大型的开放源码工程中，因为开发者可能在任意的时区工作得很晚，给予一个开发者阻止任意地方的其它开发者继续处理任意文件的能力很明显无法运转。他们最终将因为不能够在他们想要的时候开展项目而感到厌烦。nCVS通过它的无限制的签出模式解决了这个问题。签出一个文件并不给定开发者对那个文件的排它权。其它的开发者也可以对其检出，进行他们自己的修改，并且将其登记回去。n"等一下"你可能会说。"但是后面的登记不是会覆盖前面的吗"回答是不会。详细地回答就是当多个开发者对同一个文件作了修改CVS会检测，并且自动合并那些改变。n哇噢。自动的，不用担心 -- CVS 会很小心，并且将会自动合并那些只要不是对代码的同一行所作的改动。如果CVS不能安全的处理这些改动，开发者将不得不手工合并它们。从此去往何处。n有大量在许多平台上可用的CVS附加工具，它们给CVS增加了功能或使得CVS更容易使用。

历史

CVS 诞生于 1986 年，当时作为一组 shell 脚本而出现；1989年3月，Brian Berlinor用C语言重新设计并编写了CVS的代码；1993年前后，Jim Kingdon最终将CVS设计成基于网络的平台，开发者们能从Internet任何地方获得程序源代码。截至目前最新版本是2004年12月13日发布的1.12.11。

CVS 即 Concurrent Versions System

CVS是一个C/S系统，多个开发人员通过一个中心版本控制系统来记录文件版本，从而达到保证文件同步的目的。工作模式如下：

CVS服务器（文件版本库） / | （版 本 同 步） / | 开发者1 开发者2 开发者3

作为一般开发人员挑选2,6看就可以了，CVS的管理员则更需要懂的更多一些，最后还简单介绍了一些Windows下的cvs客户端使用，CVS远程用户认证的选择及与BUG跟踪系统等开发环境的集成问题。

CVS环境初始化：CVS环境的搭建 管理员 CVS的日常使用：日常开发中最常用的CVS命令， 开发人员 管理员 CVS的分支开发：项目按照不同进度和目标并发进行 管理员 CVS的用户认证：通过SSH的远程用户认证，安全，简单 管理员 CVSWEB：CVS的WEB访问界面大大提高代码版本比较的效率 管理员 CVS TAG：将$Id$ 加入代码注释中，方便开发过程的跟踪开发人员 CVS vs VSS: CVS和Virsual SourceSafe的比较 开发人员 管理员 WinCVS: 通过SSH认证的wincvs认证设置 基于CVSTrac的小组开发环境搭建：通过CVSTrac实现web界面的CVS用户管理,集成的BUG跟踪和WIKI交流 CVS中的用户权限管理：基于系统用户的CVS权限管理和基于CVSROOT/passwd的虚拟用户管理

一个系统20%的功能往往能够满足80%的需求，CVS也不例外，以下是CVS最常用的功能，可能还不到它全部命令选项的20%，作为一般开发人员平时会用cvs update和cvs commit就够了，更多的需求在实际应用过程中自然会出现，不时回头看看相关文档经常有意外的收获。

环境设置：指定CVS库的路径CVSROOT

tcshsetenv CVSROOT /path/to/cvsroot

bashCVSROOT=/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 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

一些人先在另外一个目录下导出release_1_0_patch这个分支：解决1.0中的紧急问题，

cvs checkout -r release_1_0_patch

而其他人员仍旧在项目的主干分支2.x上开发

在release_1_0_patch上修正错误后，标记一个1.0的错误修正版本号

cvs tag release_1_0_patch_1

如果2.0认为这些错误修改在2.0里也需要，也可以在2.0的开发目录下合并release_1_0_patch_1中的修改到当前代码中：

cvs update -j release_1_0_patch_1

CVSWEB：提高文件浏览效率

CVSWEB就是CVS的WEB界面，可以大大提高程序员定位修改的效率:

使用的样例可以看：http://www.freebsd.org/cgi/cvsweb.cgi

CVSWEB的下载：CVSWEB从最初的版本已经演化出很多功能界面更丰富的版本，这个是我个人感觉安装设置比较方便的：

原先在：http://www.spaghetti-code.de/software/linux/cvsweb/，但目前已经删除，目前仍可以在本站下载CVSWEB，其实最近2年FreeBSD的CVSWeb项目已经有了更好的发展吧，而当初没有用FreeBSD那个版本主要就是因为没有彩色的文件Diff功能。

下载解包：

tar zxf cvsweb.tgz

把配置文件cvsweb.conf放到安全的地方（比如和apache的配置放在同一个目录下），

修改：cvsweb.cgi让CGI找到配置文件：

$config = $ENV{'CVSWEB_CONFIG'} || '/path/to/apache/conf/cvsweb.conf';

转到/path/to/apache/conf下并修改cvsweb.conf：

CVSWEB可不能随便开放给所有用户，因此需要使用WEB用户认证：

先生成 passwd:

/path/to/apache/bin/htpasswd -c cvsweb.passwd user

修改httpd.conf: 增加

AuthName "CVS Authorization"

AuthType Basic

AuthUserFile /path/to/cvsweb.passwd

require valid-user

CVS TAGS

CVS TAGS: $Id: cvs_card.html,v 1.5 2003/03/09 08:41:46 chedong Exp $

将$Id: cvs_card.html,v 1.9 2003/11/09 07:57:11 chedong Exp $ 加在程序文件开头的注释里是一个很好的习惯，cvs能够自动解释更新其中的内容成：file_name version time user_name 的格式，比如：cvs_card.txt,v 1.1 2002/04/05 04:24:12 chedong Exp，可以这些信息了解文件的最后修改人和修改时间

几个常用的缺省文件：

default.php

/*

* Copyright (c) 2002 Company Name.

* $Header: /home/cvsroot/tech/cvs_card.html,v 1.9 2003/11/09 07:57:11 chedong Exp $

*/

?>

====================================

Default.java: 注意文件头一般注释用 /* 开始 javadoc注释用 /** 开始的区别

/*

* Copyright (c) 2002 MyCompany Name.

* $Header: /home/cvsroot/tech/cvs_card.html,v 1.9 2003/11/09 07:57:11 chedong Exp $

*/

package com.mycompany;

import java.;

/**

* comments here

*/

public class Default {

/**

* Comments here

* @param

* @return

*/

public toString() {

}

}

====================================

default.pl:

#!/usr/bin/perl -w

# Copyright (c) 2002 Company Name.

# $Header: /home/cvsroot/tech/cvs_card.html,v 1.9 2003/11/09 07:57:11 chedong Exp $

# file comments here

use strict;

日常使用：

注意：第一次导出以后，就不是通过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 "bugfixed" 甚至 -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.nam e

这个命令是给file.n ame加一个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是一个C/S系统，多个开发人员通过一个中心版本控制系统来记录文件版本，从而达到保证文件同步的目的。nnCVS是一个C/S系统，多个开发人员通过一个中心版本控制系统来记录文件版本，从而达到保证文件同步的目的。工作模式如下：nnCVS服务器（文件版本库）nn/ | / （版 本 同 步）nn/ | /nn开发者1 开发者2 开发者3nnCVS（Concurrent Version System）版本控制系统是一种GNU软件包，主要用于在多人开发环境下的源码的维护。实际上CVS可以维护任意文档的开发和使用，例如共享文件的编辑修改，而不仅仅局限于程序设计。CVS维护的文件类型可以是文本类型也可以是二进制类型。CVS用Copy-Modify-Merge（拷贝、修改、合并）变化表支持对文件的同时访问和修改。它明确地将源文件的存储和用户的工作空间独立开来，并使其并行操作。CVS基于客户端/服务器的行为使其可容纳多个用户，构成网络也很方便。这一特性使得CVS成为位于不同地点的人同时处理数据文件（特别是程序的源代码）时的首选。nn所有重要的免费软件项目都使用CVS作为其程序员之间的中心点，以便能够综合各程序员的改进和更改。这些项目包括GNOME、KDE、THE GIMP和Wine等。nnCVS的基本工作思路是这样的：在一台服务器上建立一个源代码库，库里可以存放许多不同项目的源程序。由源代码库管理员统一管理这些源程序。每个用户在使用源代码库之前，首先要把源代码库里的项目文件下载到本地，然后用户可以在本地任意修改，最后用CVS命令进行提交，由CVS源代码库统一管理修改。这样，就好象只有一个人在修改文件一样，既避免了冲突，又可以做到跟踪文件变化等。nnCVS是并发版本系统（Concurrent Versions System）的意思，主流的开放源码网络透明的版本控制系统。CVS对于从个人开发者到大型，分布团队都是有用的：nn它的客户机/服务器存取方法使得开发者可以从任何因特网的接入点存取最 新的代码。它的无限制的版本管理检出(check out：注1)的模式避免了通常的因为排它 检出模式而引起的人工冲突。 它的客户端工具可以在绝大多数的平台上使用。nnCVS被应用于流行的开放源码工程中，象Mozilla，GIMP，XEmacs，KDE，和GNOME等。 那么它到底怎么样？nn你可能会说，它非常棒，但是对于 "我"来说它能做什么？首先，基本的 ：一个版本控制系统保持了对一系列文件所作改变的历史记录。对于一个开发者来说，那就意味着在你对一个程 序所进行开发的整个期间，能够跟踪对其所作的所有改动的痕迹。对你来说，有没有出现过由于在令行上 按错键而导致一天的工作都白费的情况呢？版本控制系统给了你一个安全的网络。nn版本控制系统对任何人都有用，真的。(毕竟，谁不愿意使用一个安全的 网络呢？)但是它们经常被软件开发团队使用。在团队中工作的开发者需要能够调整他们的各自的修改；一个集 中式版本控制系统允许那样做。n代码集中的配置nn个人开发者希望一个版本控制系统的安全网络能够运行在他们的本地的 一台机器上。然而，开发团队需要一个集中的服务器，所有的成员可以将服务器作为仓库来访问他们的代码。在 一个办公室中，没有问题 --只是将仓库连到本地网络上的一台服务器上就行了。对于开放源码项目...噢， 还是没有问题，这要感谢因特网。CVS内建了客户机/服务器存取方法，所以任何一个可以连到因特网上的开发 者都可以存取在一台CVS服务器上的文件。n

调整代码

在传统的版本控制系统中，一个开发者检出一个文件，修改它，然后将 其登记回去。检出文件的开发者拥有对这个文件修改的排它权。没有其它的开发者可以检出这个文件 -- 并且只 有检出那个文件的开发者可以登记(check in：注2)所做的修改。(当然对于管理员有很多方法可以超越这个 限制。)nn想一下排它的检出可能会如何工作：Bob的兄弟检出 foo.java以便加入 注释，写好代码后他什么也没做。然后他去吃午饭了。Bob吃完午饭后，发现他的老板所指给他的一个bug在 foo.java里。他试图检出 foo.java ... 但是版本控制系统不允许他这样做，因为他的兄弟已经把它检出了。Bob不 得不等着他的兄弟吃完午饭回来(在这个 "好"日子用了两个小时)，他才可以修正bug。nn在一个大型的开放源码工程中，因为开发者可能在任意的时区工作得很 晚，给予一个开发者阻止任意地方的其它开发者继续处理任意文件的能力很明显示无法运转。他们最终将因为不 能够在他们想要的时候开展项目而感到厌烦。nnCVS通过它的无限制的检出模式解决了这个问题。检出一个文件并不给定 开发者对那个文件的排它权。其它的开发者也可以对其检出，进行他们自己的修改，并且将其登记回去。nn"等一下！"你可能会说。"但是后面的登记不是会覆盖前面的吗？"回答 是不会。详细地回答就是当多个开发者对同一个文件作了修改CVS会检测，并且自动合并那些改变。nn哇噢。自动的？不用担心 -- CVS 会很小心，并且将会自动合并那些只 要不是对代码的同一行所作的改动。如果CVS不能安全的处理这些改动，开发者将不得不手工合并它们。 从此去往何处？nn到现在为止，你已经毫不犹豫地着迷于CVS 的潜力，并且急不可待地想 开始。第一步就是去得到 适合你的平台的CVS软件。安装CVS通常就是将其从你下载的压缩包中解开这么一件 事。配置CVS 可能要小心一些，它非常依赖于你使用的平台和你的CVS代码仓库的存放地。CVShome.org存放了大 量的CVS 文档：nn。nn