基于windows平台的SVN教程

作者：东风化宇 
来源：

一、SVN工作原理

SVN（SubVersion）的基本工作思路是这样的：在一台服务器上建立一个源代码库，库里可以存放许多不同项目的源程序，由源代码库管理员统一管理这些源程序。

每个用户在使用源代码库之前，首先要把源代码库里的项目文件下载到本地（Checkout），然后用户可以在本地任意修改，最后用svn命令进行提交（ commit ），由svn源代码库统一管理修改。如下图：

SVN服务器： 运行SubVersion服务的计算机，SubVersion支持Linux和Windows，更多的是安装在Linux下。SVN提供服务有两种方式（运行方式）：独立服务器和借助 Apache 服务器，分别使用SVN协议和Http协议。
SVN客户端： 用户通过SVN客户端同SVN服务器打交道，SVN客户端分为命令行工具和图形化工具。最流行的客户端是 TortoiseSVN 。也可以在Eclipse中使用SVN插件。

二、SubVersion的使用

可以在下载SVN并安装（本文使用windows版本，过程不多说）。在SVN中集成了服务器端和客户端组件：

服务器组件（管理员用）：svnadmin、svnserve
客户端组件（程序员用）：svn

这些组件命令都位于SubVersion安装目录下的bin目录下。

友情提示： 安装完SVN后，通过”svnadmin –version”验证是否安装成功。如果出现错误“svnadmin不是内部或外部命令”，则需要手动将SVN的bin目录加入到path环境变量下。

1、创建SVN仓库

1）先创建一个目录：E:\svnrepo\repoDemo1。后面就使用该目录作为SVN仓库。

2）创建仓库：svnadmin create E:\svnrepo\repoDemo1。创建仓库后的目录结构如下：

3）启动SVN服务：svnserve -d -r E:\svnrepo\repoDemo1，如下图：

这样就启动了repoDemo1这个仓库的服务（单仓库），如果在svnrepo目录下还有其他仓库，且要同时启动多个仓库，执行svnserve -d -r E:\svnrepo即可（多仓库）。

一般情况下，访问SVN仓库的URL格式形如：svn://192.168.1.6/repoDemo1，但如果启动的是单仓库，则URL直接用：svn://192.168.1.6表示。svn协议的默认端口号为3690。

小技巧： 如果需要频繁使用该仓库，则可将该SVN服务注册成windows服务，这样在计算机开机时就可以启动该服务。如下图：

删除该windows服务：sc delete svnService。

2、SVN客户端操作（命令行）

重点：checkout（检出）、commit（提交）、update（更新）

1）在E盘下建立user1、user2两个目录，模拟两个协同工作的用户的workspace。

2） 检出：第一次 和SVN服务器交互时，需要使用checkout将仓库检出到本地。

说明： 检出一次，就建立了与SVN仓库的连接。

3） 提交：commit

在user1目录下新建Demo1.java文件，将该文件提交到SVN仓库。下图演示了三种典型的错误提交。

4） 更新：update

切换到user2的工作空间（user2目录下），user2第一次使用SVN仓库，需要检出。user2修改Demo1.java后提交。切换到user1目录，更新（update）。

5）删除与恢复：delete、revert

说明： 如果delete后，提交到服务器（commit），则服务器上的数据也被删除了（慎用）。

三、SVN的目录约定

/trunck： 开发主线
/branches： 支线副本
/tags： 标签副本（一旦创建，不允许修改）

1）使用trunk作为主要的开发目录

一般的，我们的所有的开发都是基于trunk进行开发，当一个版本（release）开发告一段落（开发、测试、文档、制作安装程序、打包等结束后），代码处于冻结状态（人为规定，可以通过hook来进行管理）。此时应该基于当前冻结的代码库，打tag。

当下一个版本/阶段的开发任务开始时，继续在trunk进行开发。此时，如果发现了上一个已发行版本（Released Version）有一些bug，或者一些很急迫的功能要求，而正在开发的版本（Developing Version）无法满足时间要求，这时候就需要在上一个版本上进行修改了。解决方法是基于发行版对应的tag，做相应的分支（branch）进行开发。

2）下图为struts2的SVN仓库目录：

现在Struts2的代码使用git管理，所以现在查看Struts2的SVN仓库是空的。

四、TortoiseSVN的使用

TortoiseSVN是现在最流行的SVN客户端工具，使用图形化界面和SVN仓库交互（作为命令行方式的替代）。关于TortoiseSVN的安装省略。

安装完成后，在任意位置右击都能看到TortoiseSVN选项。

1、基本操作

1）创建仓库

创建目录：E:\svnrepo\repoDemo2，进入该目录下，右击 — TortoiseSVN — Create repository here，并创建默认的SVN目录结构，如下图所示：

2） 检出：checkout

在E盘下建立user3、user4两个目录，模拟两个协同工作的用户的workspace。

进入user3目录下，右击 — SVN Checkout，在URL of repository中输入：file:///E:/svnrepo/repoDemo2。【此时仓库还没有启动SVN服务，所以使用file://】

3） 提交：commit

在user3/trunk目录下新建Demo1.java，在该文件上右击 — TortoiseSVN — add，则将Demo1.java纳入版本控制。然后右击 — SVN Commit，提交至代码仓库。

4） 更新：update

对user4进行上面的检出操作。并修改user4目录下的Demo1.java（如增加一个字段），并commit。

回到user3/trunk，右击 — SVN Update。

5）启动SVN服务。这步需要在命令行中输入：svnserve -d -r E:\svnrepo

6）访问SVN仓库。在任意空白位置右击 — TortoiseSVN — Repo browser，URL输入：svn://192.168.1.6/repoDemo2即可浏览SVN仓库中的内容，如下。

2、其他操作

下面的操作都位于右键菜单的TortoiseSVN中。

1）删除：delete

删除文件或目录，不能直接用Windows的删除命令来操作，那样只是没有显示出来，实际并没有删除，在更新后，删除的文件又会被更新出来的。要想从库中删除，必须选中你要删除的内容，TortoiseSVN — delete，这样才会将这个文件标记成要删除的。确认需要删除后，使用前面所讲的提交命令，就会真正的在库中删除了。

2）重命名：rename

重命名也不能直接用Windows的重命名命令来操作，必须选中你要重命名的文件，TortoiseSVN — rename。修改后提交就可以更新到仓库。

改名的处理方式相当于新增了一个以新名称命名的文件，原名称命名的文件进行了删除。

3）还原：revert

在未提交之前，你对前面做的操作反悔了，可以使用revert来恢复。

4）检查更新：Check for modifications

① 此功能可以显示你所做的修改有哪些还没有提交的。② 还可以看到版本库里的改动，即别人提交了哪些文件的改动，你还没更新到本地。

5）导出：export

使用SVN的工作空间每个目录下面都有一个.svn隐藏目录，利用SVN的export命令可轻松地导出不含.svn目录的工作空间。

3、冲突问题的解决（☆）

何时发生： 接着4.1节中的操作，假设user3和user4目录下的Demo1.java都更新到了最新版本。user3修改Demo1.java，提交至仓库。若user4也修改Demo1.java并提交，此时user4的TortoiseSVN会报提交版本过时的错误，并提醒user4需要更新，更新时就会发生冲突。如下图：