【转】使用Subversion

 

本文目的

让未使用过版本控制器软件或者未使用过subversion软件的人员尽快上手。

subversion的使用技巧很多，这里只总结了最小使用集，即主要的基本功能，能够用来应付日常工作。

因此不涉及subversion服务器端的搭建和配置。

为什么要使用版本控制

当多人共同开发同一个软件时，会涉及源代码的共享以及带来的相关问题，比如追究某个代码是由谁在什么时间修改的。

下面列出版本控制带来的好处：

• 为团队提供了所有项目文档的回退按钮，个人IDE工具只能提供某个文件的回退按钮，而不能做到，比如回退到2008年6月12日下午3点10分时的所有项目文件；
• 支持多个开发人员在可控的方式下为相同的代码工作；
• 版本控制系统保存了文档在过去的各个改动，便于查找是谁，在何时，因为什么修改了文档；
• 支持在文档的主线上同时有多个版本（版本的分支和合并是版本控制的主要手段，一些开发团队仅仅是简单的共享代码主干）；
• 支持查询在某个时点上项目各个文档的状态，可用于研究生产效率等（比如，统计项目哪个时期代码提交最活跃，以及每个人的代码提交频次等等），也可用于对以前的软件发行版的再发行（比如，以前构建的2.0版本的安装包丢失了，那么可以通过版本控制器记录的历史重新回溯到那个版本，然后重新构建出安装包）。

为什么使用subversion

首先，考虑的是使用免费开源和轻量级的版本控制器。

第二，要求使用比较广泛，可选的有cvs和svn。

这里选择svn，主要考虑是比较好集成apache使用，提交代码支持原子级操作（即，比如提交3个文件，如果因为网络或者其他原因，上传2个文件后中断，svn能做到服务器端回滚到提交前的状态，而cvs做不到这点，需要手工检查和恢复）。

subversion的程序构成

subversion程序，和mysql很类似，是c/s结构的，有客户端和服务器端。服务器端和客户端都是通过命令行方式启动和执行的。本文只会使用到客户端的命令。

第三方提供了各种图形界面的客户端工具，比如eclipse插件subclipse，windows图形界面工具tortoiseSVN。这些后面会提到它们的基本使用。

subversion资源

• subversion官方网站：http://subversion.tigris.org/
• subclipse官方网站：http://subclipse.tigris.org/
• tortoiseSVN官方网站：http://tortoisesvn.tigris.org/
• 使用subversion进行版本控制中文版在线版本：http://www.subversion.org.cn/svnbook/

安装subversion

有关subversion和subclise的安装暂略，因为目前提供的虚拟机开发环境已经安装和配置。

tortoiseSVN，可到官方网站上下载最新版本的windows安装包，默认安装，不需要做其他设置，安装后需要重启计算机。能在资源管理器中鼠标右键菜单看到如下图所示条目，就说明安装成功。

使用subversion

日常工作中使用subversion仅仅是几个命令或者操作，并不复杂。但是它内部的一些机制需要逐渐去理解。

检出代码

在刚开始进入一个开发队伍的时候，已经有版本控制和软件项目，使用的第一个命令往往是检出（checkout）代码。或者当使用和研究开源软件的时候，也是第一个要用到这个命令。这个命令的作用是把项目的源代码下载到用户本地，并且带有版本控制信息。

比如，执行以下命令获取一个项目的源代码：

svn cohttp://easymorse.googlecode.com/svn/trunk/vfs.demo/

这个命令将在本地当前目录建vfs.demo目录并将该服务器目录下的所有文件下载到本地，并且，会生成隐藏文件.SVN目录，用于记录版本控制信息。

tortoiseSVN有图形界面的检出操作，但是命令行方便快捷，建议使用命令行。

如果使用eclipse并安装了subclipse插件，可以通过插件导入项目。

然后，

选择或者新建资源库位置，

选择资源库中的项目目录。

然后，就可以完成（finish）了。

初始导入

何时使用初始导入，比如，对于java开发人员来说，在eclipse中编写了一个项目，并决定把项目共享到版本控制器上，这时就需要初始导入操作了。

以下以subclipse为例说明初始导入的步骤。

第一步，选择share project，共享你的项目：

选择通过svn共享项目：

填写svn提交的url：

这个url，需要subversion的管理员告知你，还有用户名和密码。如果想练习一下，google提供了免费的svn，你可以通过：http://code.google.com 申请项目，这样就会有类似我上面的url和权限。

然后可以直接点击finish，完成初始提交。选择next，可以做定制模块名和初始提交的信息，一般不需要。

如果你的svn服务器使用了https协议，需要接受一个数字证书，一般选择永久接受。

之后，会要求输入用户名和密码。建议勾选保存密码，否则会很麻烦。

这样，再看项目，会发现条目上多了问号，这时需要选择哪些目录和文件需要提交，哪些需要忽略，比如生成的class文件等。

选择需要忽略的文件或者目录，这时需要切换到导航视图下才能看到所有文件和目录：

从导航视图看到的情况：

选中需要忽略的目录和文件，操作svn：

然后提交整个项目即可。有关提交的操作见下文。

更新项目

项目在提交前，应该先做更新项目操作。比如有一个文件a.txt，已经提交到svn中，这样，可能有其他用户提交了新的改动到a.txt，你现在又修改了a.txt，准备提交你的改动。先操作更新a.txt，这样如果该文件在svn服务器已经改动，会将改动加入到当前本地的a.txt中。

在subclipse中的操作：

提交代码

提交代码，一般会级联当前目录下所有改动的内容。

删除代码

对于不再使用的代码，可以直接删除掉，比如通过windows删除文件，通过ubuntu的rm命令或者通过eclipse的delete功能，然后提交项目，subclipse会知道哪个文件被删除了，并将这个变化通知给svn服务器。

还原代码

如果代码做了改动，可以是多个文件，也可以删除了文件或者新增了文件，但是没有提交到svn服务器，可以通过还原功能恢复到改动前的样子。

版本的分支与合并

版本的分支和合并，是版本控制的核心功能。

比如，软件通过版本的分支，将项目分配给多人做分工开发，通过版本合并，将这些分工实现的代码合并到新的版本中；或者，修改代码bug的时候，可以先打出一个版本分支，保留出现bug的版本，比如分支版本名称为pre_fix_bug_2201，这里2201表示bug的代号，然后针对这个分支做修改fix这个bug，再将修改后的内容提交到一个新的分支版本，比如post_fix_bug_2201，再到适当时候将这个分支合并到代码主干中去。

以上说了一下版本分支与合并的用途，这里简单说一下svn版本分支合并的基本原理。

首先是版本分支，实际上是将当前版本“copy”到分支上，非常类似windows下，将某个目录的快捷方式复制到其他路径。这种copy，可以说是轻量级copy或者叫廉价copy，不是复制版本内容，而是做一个内部的引用。这样的copy很快，对服务器也没有空间上的开销。

版本的合并，是svn开发中的难点，当做版本合并的时候，服务器会试图智能的合并同一个文件的不同版本，可能会带来版本冲突，这需要操作者做手工的处理，消除版本冲突。合理分工的项目应该可以通过管理手段尽量避免这种情况。

以下是通过subclipse演示版本分支的操作。首先，项目文档应该已经全部提交，然后，选择

然后，填写url，一般是在tags/目录下：

然后默认选项，next即可，然后选择finish按钮。在svn的相应路径下就会有一个同名的项目。

打分支，实际上就是建立了一个项目的轻量级copy。

如何从版本的一个分支切换到另外一个分支，这也是很重要的，它能帮助你轻松在不同的项目版本中自动切换，而不必在eclipse里维持多个项目。

选择要切换的项目版本路径，或者直接输入亦可。

 

然后点击ok后，项目即可切换到该版本下。

在分支上做了改动，并且已经提交（一般tags目录下的项目约定是只读的，不建议改动，这里是为了举例方便），那么，可以将这个版本合并到trunk（主干）代码中，让主干也拥有最新的代码。

 

选择需要合并的源，比如从tags上面一个版本，合并到主干（trunk）代码中。

之后，需要设置一些合并的特性，这里默认配置即可。

执行完毕后，会有一个合并报告，可见没有出现冲突情况。

这时候看源代码，可以发现有改动，这些改动就是合并过来的代码。

改动如果没有问题，就可以提交，这样就完成了一次版本的合并工作。

 

 

“还原”已经提交的改动

如果文档没有提交，还原是很容易的，只需执行还原（revert）就可以了。有时候，已经提交了代码，结果发现了问题，需要回退到之前提交的版本，就不是很容易了。

这时候的还原，其实是将以前的某个修订本（revision）覆盖当前的本地工作拷贝。然后再提交这些改动，成为新的修订本。

下面演示一下。

首先提交了一个版本的改动，这是以后需要还原回来，这里，为了以后还原方便，要在提交的消息中说明改动了什么。（这一步在开发中是必须的，是纪律）

下面，再修改一下项目，然后提交一次，这里故意增加一个文件。

提交以后，后悔了，想恢复到前一个修订版。虽然可以通过版本号进行覆盖还原，但是一般人是无法记忆这个版本号的，另外就是实际情况往往更复杂，不会像示例中那样是相邻的两个修订版。

所以提交修订版时的注解消息就显得特别重要。

这时可以通过svn的日志功能查看到这些版本和它们的注释消息。

看到历次版本的消息内容。

这样，根据注释，我们很容易找到需要还原到以前的那个修订版。如果不放心，我们还可以根据上下文菜单，对比两个修订版的区别。

看比较结果。可以看出，增加了一个文件，另外一个文件中有一处差异。

那么，可以确定是从125修订版恢复（还原）。

更改后的项目，相当于用125修订版还原了126修订版。

可以看到126版本添加的文件不见了，另外VfsDemo.java文件也还原到125版本的内容。这时提交将成为127版本，这个版本其实就是125版本。算是还原了主干（trunk）上的代码。

刷新历史，可以看到修订版已经生效。