52、版本控制工具综合指南

版本控制工具综合指南

1. 版本控制概述

版本控制在软件开发和文档管理中至关重要，它能帮助我们跟踪文件的变化、恢复到旧版本、协作开发等。常见的版本控制工具有 CVS、Subversion、RCS 等，不同的工具各有优缺点，适用于不同的场景。

2. CVS 版本控制

2.1 版本比较与回退操作

可以使用cvs diff命令比较当前版本与指定版本的差异，使用cvs update命令回退到旧版本或恢复到最新版本。以下是具体示例：

# 比较当前版本与 r1.2 的差异 /home/jp/cvs.scripts$ cvs diff -r1.2 hello # 回退到 r1.2 版本 /home/jp/scripts$ cvs update -r1.2 hello # 恢复到最新版本 /home/jp/cvs.scripts$ cvs update -rHEAD hello

2.2 相关参考资料

• man cvs
• man rcs2log
• man cvs-pserver
• The official CVS web site
• CVS Docs and Cederqvist manual
• Windows shell extention for CVS
• “Introduction to CVS”
• “CVS Administration”
• “Tracking Changes in CVSm”
• “CVS Third-Party Tools”
• “Top 10 CVS Tips”

3. Subversion 版本控制

3.1 Subversion 简介

Subversion 旨在成为开源社区中 CVS 的有力替代品。它具有以下优点：
- 比 CVS 和 RCS 更新。
- 更简单，易于理解和使用。
- 原子提交，便于跟踪整个项目的状态。
- 易于访问远程仓库。
- 支持文件和目录重命名并保留历史记录。
- 轻松处理二进制文件和符号链接等对象。
- 对中央仓库的修改有更官方的支持。

同时，它也有一些缺点：
- 对于复杂项目，与 CVS 不完全兼容。
- 由于依赖较多，从头构建或安装可能更复杂。

3.2 Subversion 操作示例

3.2.1 创建新仓库

/home/jp$ svnadmin --fs-type=fsfs create /home/jp/svnroot

3.2.2 创建新项目并导入

/home/jp$ cd /tmp /tmp$ mkdir -p -m 0700 scripts/trunk scripts/tags scripts/branches /tmp$ cd scripts/trunk /tmp/scripts/trunk$ cat << EOF > hello > #!/bin/sh > echo 'Hello World!' > EOF /tmp/scripts/trunk$ cd .. /tmp/scripts$ svn import /tmp/scripts file:///home/jp/svnroot/scripts

3.2.3 检出项目并更新

/tmp/scripts$ cd /home/jp$ svn checkout file:///home/jp/svnroot/scripts

3.2.4 检查状态

/home/jp/scripts/trunk$ svn info /home/jp/scripts/trunk$ svn status -v /home/jp/scripts/trunk$ svn status

3.2.5 添加新脚本

/home/jp/scripts/trunk$ cat << EOF > mcd > #!/bin/sh > mkdir -p "$1" > cd "$1" > EOF /home/jp/scripts/trunk$ svn add mcd

3.2.6 提交更改

/home/jp/scripts/trunk$ svn ci

3.2.7 查看差异并提交

/home/jp/scripts/trunk$ svn up /home/jp/scripts/trunk$ vi hello /home/jp/scripts/trunk$ svn diff hello /home/jp/scripts/trunk$ svn -m '* Fixed syntax error' commit

3.2.8 查看文件历史

/home/jp/scripts/trunk$ svn log hello

3.2.9 添加元数据并提交

/home/jp/scripts$ vi hello /home/jp/scripts/trunk$ svn propset svn:keywords "Id" hello /home/jp/scripts/trunk$ svn ci -m'Added ID keyword' hello

3.2.10 版本比较与回退

/home/jp/scripts/trunk$ svn diff -r2 hello /home/jp/scripts/trunk$ svn update -r2 hello /home/jp/scripts/trunk$ svn update -rHEAD hello

3.3 相关参考资料

• man svn
• man svnadmin
• man svndumpfilter
• man svnlook
• man svnserve
• man svnversion
• The Subversion web site
• TortoiseSVN
• Version Control with Subversion
• SVN static builds for Solaris, Linux, and Mac OS X
• “Subversion for CVS Users”
• Version control system comparison

4. RCS 版本控制

4.1 RCS 简介

RCS 是当时的一项革命，是 CVS 的基础。它的优点是比没有版本控制要好，但也存在很多缺点：
- 不允许对同一文件进行并发访问。
- 没有中央仓库的固有概念。
- 没有远程仓库的概念。
- 只跟踪文件更改，不考虑目录。
- 对二进制文件和符号链接等对象支持较差。

4.2 RCS 操作示例

4.2.1 创建脚本目录并创建脚本

/home/jp$ mkdir -m 0754 bin /home/jp$ cd bin /tmp/scripts/bin$ cat << EOF > hello > #!/bin/sh > echo 'Hello World!' > EOF

4.2.2 初次提交

/home/jp/bin$ ci hello

4.2.3 处理文件状态

/home/jp/bin$ co -u hello /home/jp/bin$ rm hello,v /home/jp/bin$ mkdir -m 0755 RCS /home/jp/bin$ ci -u hello

4.2.4 编辑并提交更改

/home/jp/bin$ co -l hello /home/jp/bin$ echo "Hi Mom..." >> hello /home/jp/bin$ ci -l hello

4.2.5 查看差异并提交

/home/jp/bin$ vi hello /home/jp/bin$ rcsdiff hello /home/jp/bin$ ci -u -m'* Fixed syntax error' hello

4.2.6 查看文件历史

/home/jp/bin$ rlog hello

4.2.7 添加元数据并提交

/home/jp/bin$ co -l hello /home/jp/bin$ vi hello /home/jp/bin$ ci -u -m'Added ID keyword' hello

4.2.8 版本比较与回退

/home/jp/bin$ rcsdiff -r1.2 hello /home/jp/bin$ co -r hello

4.3 Workon 脚本

以下是一个可以简化 RCS 使用的脚本：

#!/usr/bin/env bash # cookbook filename: workon # workon--Work on a file in RCS # Set a sane/secure path and export it PATH=/usr/local/bin:/bin:/usr/bin export PATH VERSION='$Version: 1.4 $' # JP Vossen COPYRIGHT='Copyright 2004-2006 JP Vossen (http://www.jpsdomain.org/)' LICENSE='GNU GENERAL PUBLIC LICENSE' CAT='/bin/cat' if [ "$1" = "-h" -o "$1" = "--help" -o -z "$1" ]; then ${CAT} <<-EoN Usage: $0 {file} Work on a file in RCS. Create the RCS subdirectory if necessary. Do the initial checkin if necessary, prompting for a message. Must be in the same directory as the file to be worked on. EoN exit 0 fi # Use a pseudo central repository RCSHOMEDIR='/home/rcs' # Make sure $VISUAL is set to something [ "$VISUAL" ] || VISUAL=vi ################################################################### # Start of Main program # Make sure RCS Home Dir exists if [ ! -d $RCSHOMEDIR ]; then echo "Creating $RCSHOMEDIR..." mkdir -p $RCSHOMEDIR fi # Make sure there is no local RCS directory if [ -d RCS -a ! -L RCS ]; then echo "Local 'RCS' already exists--exiting!" exit 2 fi # Make sure the destdir exists if [ ! -d $RCSHOMEDIR$PWD ]; then echo "Creating $RCSHOMEDIR$PWD..." mkdir -p $RCSHOMEDIR$PWD fi # Make sure the link exists if [ ! -L RCS ]; then echo "Linking RCS --> $RCSHOMEDIR$PWD." ln -s $RCSHOMEDIR$PWD RCS fi if [ ! -f "RCS/$1,v" ]; then # If the file is not ALREADY in RCS add it as v1.0. echo 'Adding "Initial Revision/Default" of file to RCS...' # Get input echo -n 'Describe this file: ' read logmsg # Check in v1.0 ci -u1.0 -t-"$logmsg" -m'Initial Revision/Default' $1 else # If the file is in RCS, work on it. # Checkout the file in locked mode for editing co -l $1 # Edit the file locally $VISUAL $1 # Check the file back in, but keep a read-only copy out for use ci -u $1 fi

4.4 相关参考资料

• man ci
• man co
• man ident
• man merge
• man rcs
• man rcsclean
• man rcsdiff
• man rcsmerge
• man rlog
• man rcsfreeze
• Applying RCS and SCCS, Chapter 3
• “BSD Tricks: Introductory Revision Control”

5. 其他版本控制功能

5.1 文字处理器的版本控制功能

一些文字处理器，如 OpenOffice.org Writer 和 Microsoft Word，具有文档比较、更改跟踪和版本管理等功能。

5.1.1 文档比较

当文档的原生文件格式难以使用其他差异工具时，文档比较功能可以帮助我们比较文档。不同文字处理器的访问方式如下表所示：
| 功能 | Writer 菜单选项 | Word 菜单选项 |
| ---- | ---- | ---- |
| 文档比较 | Edit ➝ Compare Document | Tools ➝ Compare and Merge Documents |
| 更改跟踪 | Edit ➝ Changes | Tools ➝ Track Changes |
| 版本管理 | File ➝ Versions | File ➝ Versions |

5.1.2 更改跟踪和版本管理的注意事项

更改跟踪和版本管理功能会使文档不断增大，因为更改的内容会被保留，删除的内容只是被标记为删除。如果不小心开启，可能会导致信息泄露。最新版本的工具会尝试在文档转换为 PDF 或发送邮件之前警告用户或清除私人信息。

6. 版本控制工具操作流程总结

6.1 版本控制工具操作流程对比

为了更清晰地展示不同版本控制工具的操作流程，下面以创建项目、提交更改、查看历史这几个常见操作为例进行对比：
| 操作 | CVS | Subversion | RCS |
| ---- | ---- | ---- | ---- |
| 创建项目 | 暂无示例 |svnadmin --fs-type=fsfs create /home/jp/svnroot
svn import /tmp/scripts file:///home/jp/svnroot/scripts|mkdir -m 0754 bin
cd bin
cat << EOF > hello
#!/bin/sh
echo 'Hello World!'
EOF
ci hello|
| 提交更改 |cvs update -rHEAD hello|svn ci|ci -u -m'* Fixed syntax error' hello|
| 查看历史 | 暂无示例 |svn log hello|rlog hello|

6.2 版本控制工具操作流程图

graph LR classDef startend fill:#F5EBFF,stroke:#BE8FED,stroke-width:2px; classDef process fill:#E5F6FF,stroke:#73A6FF,stroke-width:2px; classDef decision fill:#FFF6CC,stroke:#FFBC52,stroke-width:2px; A([开始]):::startend --> B{选择工具}:::decision B -->|CVS| C(创建项目):::process B -->|Subversion| D(创建仓库):::process B -->|RCS| E(创建脚本目录):::process C --> F(提交更改):::process D --> G(导入项目):::process E --> H(创建脚本):::process F --> I(查看历史):::process G --> J(提交更改):::process H --> K(初次提交):::process J --> L(查看历史):::process K --> M(编辑并提交):::process M --> N(查看历史):::process I --> O([结束]):::startend L --> O N --> O

7. 版本控制工具的选择建议

7.1 根据项目规模选择

• 小型项目：如果是个人的小型项目，对版本控制的功能要求不高，RCS 可以满足基本的文件版本管理需求。例如个人的脚本编写项目，使用 RCS 可以简单地记录文件的修改历史。
• 中型项目：对于团队协作的中型项目，CVS 是一个不错的选择。它有一定的社区支持和使用基础，能满足多人协作开发的基本需求。
• 大型项目：大型项目建议使用 Subversion。它的原子提交、易于访问远程仓库等特性，能更好地管理复杂的项目结构和多人协作开发。

7.2 根据文件类型选择

• 文本文件为主：CVS、Subversion 和 RCS 都能很好地处理文本文件的版本控制。
• 包含大量二进制文件：Subversion 更适合，因为它能轻松处理二进制文件，而 RCS 对二进制文件的支持较差。

7.3 根据团队技术栈选择

如果团队成员对某种版本控制工具比较熟悉，为了减少学习成本，建议优先选择该工具。例如团队成员之前主要使用 CVS，那么在新项目中继续使用 CVS 可以更快地上手。

8. 版本控制工具的最佳实践

8.1 定期提交更改

无论是使用哪种版本控制工具，都应该养成定期提交更改的习惯。这样可以及时记录项目的修改历史，避免因意外情况丢失重要的修改。例如在完成一个功能模块的开发后，及时提交代码，并附上详细的提交日志。

8.2 编写清晰的提交日志

提交日志是记录每次更改的重要信息，应该清晰、准确地描述本次更改的内容。例如在提交代码时，使用类似“修复了登录功能的 Bug”、“添加了新的用户注册界面”这样的描述，方便后续查看和理解项目的修改历史。

8.3 合理使用分支和标签

在 Subversion 和 CVS 中，分支和标签是非常有用的功能。分支可以用于开发新功能、修复 Bug 等，标签可以用于标记项目的重要版本，如发布版本。例如在开发新功能时，可以创建一个新的分支，在该分支上进行开发，开发完成后再合并到主分支。

8.4 定期备份仓库

为了防止数据丢失，应该定期备份版本控制仓库。对于 Subversion 和 CVS，可以备份仓库所在的目录；对于 RCS，可以备份 RCS 文件。

9. 总结

版本控制在软件开发和文档管理中起着至关重要的作用。不同的版本控制工具各有优缺点，适用于不同的场景。CVS 是一个经典的版本控制工具，有一定的使用基础；Subversion 是较新的工具，功能更强大，适合大型项目；RCS 是 CVS 的基础，虽然有很多局限性，但在一些简单场景下仍可使用。此外，一些文字处理器也提供了版本控制相关的功能，可以在文档处理中发挥作用。在实际使用中，我们应该根据项目的规模、文件类型、团队技术栈等因素选择合适的版本控制工具，并遵循最佳实践，以提高项目的开发效率和管理质量。