Subversion快速入门教程

如何快速建立Subversion服务器，并且在项目中使用起来，这是大家最关心的问题，与CVS相比，Subversion有更多的选择，也更加的容易，几个命令就可以建立一套服务器环境，可以使用起来，这里配套有动画教程。

本文是使用Subversion最快速的教程，在最短的时间里帮助您建立起一套可用的服务器环境，只需略加调整就可以应用到实际项目当中。 本教程分为以下几个部分，为了说明简单，教程是在windows下使用的方式，以方便资源有限的项目使用。在UNIX环境下，只是安装方式不同，命令执行并无太大区别。

官方下载：

    

服务器和程序下载 ： http://subversion.tigris.org/getting.html#binary-packages

Windows常用客户端TortoiseSVN：http://tortoisesvn.net/downloads AnkhSVN（Visual Studio插件）：http://ankhsvn.open.collab.net/ Subclipse（Eclipse插件）：http://subclipse.tigris.org/ SCPlugin（Mac OS x客户端）：http://scplugin.tigris.org/

1，软件下载

下载Subversion服务器程序。

到官方网站的下载二进制安装文件，来到二进制包下载部分，找到 Windows NT, 2000, XP and 2003部分，然后选择Apache 2.0 或

者 Apache 2.2，这样我们可以看到许多下载的内容，目前可以下载Setup-Subversion-1.5.3.msi 。

下载Subversion的Windows客户端TortoiseSVN。

TortoiseSVN是扩展Windows Shell的一套工具，可以看作Windows资源管理器的插件，安装之后Windows就可以识别Subversion的工作目录。

官方网站是TortoiseSVN ，下载方式和前面的svn服务器类似，在Download页面的我们可以选择下载的版本，目前的最高稳定版本的安装文件为TortoiseSVN-1.5.5.14361-win32-svn-1.5.4.msi。

2，服务器和客户端安装

服务器安装，直接运行Setup-Subversion-1.5.3.msi ，根据提示安装即可，这样我们就有了一套服务器可以运行的环境。

安装TortoiseSVN，同样直接运行TortoiseSVN-1.5.5.14361-win32-svn-1.5.4.msi按照提示安装即可，不过最后完成后会提示是否重启，其实重启只是使svn工作拷贝在windows中的特殊样式生效，与所有的实际功能无关，这里为了立刻看到好的效果，还是重新启动机器。

3，建立版本库（Repository）

运行Subversion服务器需要首先要建立一个版本库（Repository），可以看作服务器上存放数据的数据库，在安装了Subversion服务器之后，可以直接运行，如：

svnadmin create E:\\svndemo\\repository

就会在目录E:\\svndemo\\repository下创建一个版本库。 我们也可以使用TortoiseSVN图形化的完成这一步：

在目录E:\\svndemo\\repository下\"右键->TortoiseSVN->Create Repository here...“， 然后可以选择版本库模式， 这里使用默认即可， 然后就创建了一系列目录和文件。

4，配置用户和权限

来到E:\\svndemo\\repository\\conf目录，修改svnserve.conf： # [general]

# password-db = passwd 改为： [general]

password-db = passwd

然后修改同目录的passwd文件，去掉下面三行的注释： # [users]

# harry = harryssecret # sally = sallyssecret 最后变成： [users]

harry = harryssecret sally = sallyssecret

在passwd文件中，“=”前的字符就是用户名，后面的就是密码。还要注意“[users]”前面的注释“#”一定要删除掉。

5，运行独立服务器

在任意目录下运行：

svnserve -d -r E:\\svndemo\\repository 我们的服务器程序就已经启动了。注意不要关闭命令行窗口，关闭窗口也会把svnserve停止。

6，初始化导入

来到我们想要导入的项目根目录，在这个例子里是E:\\svndemo\\initproject，目录下有一个readme.txt文件：

右键->TortoiseSVN->Import...

在URL of repository输入“svn://localhost/trunk” 在Import Message中输入你的日志信息

完成之后目录没有任何变化，如果没有报错，数据就已经全部导入到了我们刚才定义的版本库中。

需要注意的是，这一步操作可以完全在另一台安装了TortoiseSVN的主机上进行。例如运行svnserve的主机的IP是133.96.121.22，则URL部分输入的内容就是“svn://133.96.121.22/trunk”。

7，基本客户端操作

取出版本库到一个工作拷贝：

来到任意空目录下，在本例中是E:\\svndemo\\wc1，运行右键->Checkout，在URL of repository中输入svn://localhost/trunk，这样我们就得到了一份工作拷贝。

在工作拷贝中作出修改并提交：

打开readme.txt，作出修改，然后右键->Commit...，这样我们就把修改提交到了版本库，我们可以运行。

察看所作的修改：

readme.txt上右键->TortoiseSVN->Show Log，这样我们就可以看到我们对这个文件所有的提交。在版本1上右键->Compare with working copy，我们可以比较工作拷贝的文件和版本1的区别。

FAQ1. 什么是推荐的版本库布局？trunk是什么意思？trunk有什么意义？

一个Subversion版本库实现了一种版本化的文件系统，版本库只是一个包含目录和文件的文件系统，而且它的文件系统是版本化的，并且实现了”廉价”拷贝，让它的这种操作比传统文件系统便宜很多，但是版本库本身还是像一个文件系统：Subversion本身没有特别的目录或名称用来代表trunk或branches，他们只是文件系统的普通目录，这依赖于你给这些目录名和结构的一种意义。

也就是说，社区已经采纳了多种普通的布局作为最佳实践，因此一个人可以将其视为推荐方式。如果你的版本库是公共访问的，根据这些习惯，用户可以方便的访问版本库来查找他们所需要的。 有两种常见的布局： trunk branches tags

第一种布局是版本库包含一个项目或一组紧密联系项目的最佳选择，这个布局非常好用，因为分支与标签整个项目或一组项目会非常简单，只需要一个简单的命令：

svn copy url://repos/trunk url://repos/tags/tagname -m \"Create tagname\"

这可能是最常用的版本库布局，被许多开源项目采用，就像Subversion本身和Subclipse，这是大多数主机站点，如Tigris.org, SourceForge.net和Google Code遵循的方法，这些站点的每个项目有自己的版本库。

另一种布局是针对一个版本库包含不相关项目的最佳选择。 ProjectA trunk branches tags ProjectB trunk branches tags

在这种布局里，每个项目会存在顶级目录里，然后该目录之下创建trunk/branches/tags，其中与第一种布局相同，这只是将项目放到自己版本库方式的替换，他们都在一个版本库中。Apache软件基金会使用这种布局方式来存放他们的所有项目在一个版本库。 通过这种布局，每个项目都有自己的分支和标签，可以很容易使用一个命令创建分支和标签，就像前面展示的：

svn copy url://repos/ProjectA/trunk url://repos/ProjectA/tags/tagname

-m \"Create tagname\"

这种布局可以简单的创建同时包含ProjectA和ProjectB的标签，你可以这样做，但是需要多个命令，你也要决定是否创建一个特别的目录存放这种分支和标签，如果你需要经常这样做，你或许应该考虑第一种布局。

至于版本库中目录的名称，再说一遍：只是一种习惯，他们在Subversion中没有特别含义。

“trunk”可以认为是项目的开发主线，你可以称之为 “main”，”mainline”，”production”或任何你喜欢的名字。

“branches”是放置分支的地方，人们因各种目的使用分支，你或许希望通过特性分支或客户修改分支来隔离你的发布或维护分支等，在这个例子里，你可以在branches创建一层目录，或只是在顶级目录创建多个分支目录。

“tags”也不会被Subversion特别对待，他们只是习惯，或许通过钩子脚本或授权规则进行强制，来指明你创建了一个时间点的快照，通常情况下tags与分支的区别就是tags一旦创建不能修改，你也可以将标签目录叫做”releases” ，”snapshots”，”baselines”或任何你喜欢的。

记住，名称对你有意义，不是Subversion。最后，Subversion的架构，全局修订版本经常使得标签没有必要，我不知道只是因为要创建tag而创建tag有什么意义，如果你需要在特定时间点重建软件，你可以

通过svn log来确定相关的修订版本号。tags对于版本库的”外部”用户很有用，或许QA/Release团队需要执行构建，或许是一个内部开发小组希望在另一个产品使用发布版本，或是外部用户或客户希望根据字面含义从版本库获取发布快照，在这些场景中，创建tag是保证获取正确代码的最简单方法，也需要有好的交流机制来指明发布快照。

最后，我希望指出Subversion版本库的布局是可以修改的，你可以一直重组和重构布局，最坏情况下，会让用户调整他们的工作拷贝，但不会让你从头再来，你应该自由的改名，移动目录或任何你希望改变版本库的方式去做.