SVN快速入门（TSVN）

作者:	北京群英汇信息技术有限公司
网址:	http://www.ossxp.com/
版本:	0.1-35
日期:	2011-07-05 10:51:59
版权信息:

目录

• 1   安装TortoiseSVN
• 2   使用需知
• 3   TSVN的使用
  • 3.1   浏览远程版本库
  • 3.2   检出远程版本库到工作区
  • 3.3   文件提交
  • 3.4   提交日志
  • 3.5   反删除文件

SVN的内容很多，即使其简明手册浓缩在一页纸很难，但是用一张超大的纸也许可以装得下。下面就是Windows平台下TortoiseSVN的简明操作手册，关于SVN的更多内容参见群英汇的SVN培训讲义或如下SVN官方文档。

• SVNBOOK (Version Control with Subversion)

  http://svnbook.red-bean.com/nightly/en/index.html

• TSVN manual

  http://tortoisesvn.net/docs/release/TortoiseSVN_zh_CN/index.html

1   安装TortoiseSVN

TortoiseSVN简称TSVN，是在Windows平台上广泛使用的Subversion（SVN）客户端。该软件的标识是一只小乌龟（Tortoise），可以从 TSVN官方网站 下载TSVN软件的最新版。

1. 下载并安装TSVN。

   TSVN安装包有32位和64位两个版本，下载安装前先确认你Windows的版本（注意不是Windows XP和Windows 7的版本，而是由所支持的CPU指令架构是32位还是64位决定），如果不确定就先试试32位版本吧。

2. 下载并安装中文语言包。

   同样中文语言包也有32位和64位之分，根据你操作系统的版本进行选择。

3. 先安装TSVN，再安装中文语言包，然后设置TSVN，将默认语种设置为中文。

   设置方法如下：

   • 在资源管理器中单击鼠标右键，弹出菜单参见图1。

     

     图1：资源管理器右键弹出菜单

   • 设置语种为中文。参见图2。

     

     图2：设置TSVN语种

2   使用需知

TSVN是一个和Windows的资源管理器整合的应用，可从资源管理器、Windows的文件打开对话框甚至桌面上，通过单击鼠标右键，从弹出的右键菜单中调用相应功能。

使用TSVN前，需要从管理员那里确认：

1. SVN版本库的地址是什么？例如: https://svn.ossxp.com/svn/demo
2. 您的用户名和口令。

3   TSVN的使用

3.1   浏览远程版本库

项目的SVN版本库中可能包含非常多的文件，且开发主线、分支、里程碑都作为独立的目录存在，因此从项目的根目录检出版本库不是一个好主意。可以利用TSVN的远程版本库浏览功能，先看看版本库都有什么内容，然后根据需要检出。

1. 在资源管理器中的右键菜单选择“版本库浏览器”，如图3所示。

   

   图3：右键菜单中选中版本库浏览器

2. 在弹出的URL地址录入框中输入版本库地址，如图4所示。

   

   图4：输入版本库URL地址

3. 因为连接的是HTTPS协议的SVN版本库，会询问是否接受HTTPS网站证书。选择总是接受，则以后访问任何该服务器上的版本库都不会再弹出类似证书确认对话框了。如图5所示。

   

   图5：HTTPS网站证书确认

4. 在弹出的认证对话框中输入SVN服务器登录的用户名和口令。如图6所示。

   

   图6：输入用户名和口令

5. 显示远程版本库的目录树。从图7可以看出该版本库有三个顶级目录，分别是：trunk（主线目录），branches（保存分支的根目录），tags（保存里程碑的根目录）。

   

   图7：输入用户名和口令

6. 可以直接通过版本库浏览器打开文件查看，或者进行其他操作，参见图8。

   

   图8：直接通过版本库浏览器打开文件

3.2   检出远程版本库到工作区

虽然可以通过版本库浏览器直接查看远程版本库中的文件，甚至可以删除远程版本库的文件，但是如果要修改版本库中的文件，并将修改后的文件更新到远程版本库中，首先就需要用到SVN的检出命令。

检出动作就是将远程版本库的目录检出到本地的一个目录中。这个检出动作的目标目录（本地目录）称为本地工作区目录。

1. 在资源管理器的右键菜单中选择”SVN检出“，或通过版本库浏览器选择要检出的目录，点击鼠标右键，如图9所示。

   

   图9：版本库浏览器中的右键菜单

2. 弹出的检出对话框，确认正确填写了版本库URL和目标目录（即标记为”检出至目录“）。如图10。

   

   图10：检出对话框

3. 检出一旦开始，显示检出的整个过程。检出的速度视网络带宽和数据下载量而异。如图11。

   

   图11：检出过程

4. 检出后，工作区目录下的文件和目录的图标会叠加上TSVN的标识，可以很容易的识别哪些文件被改动过，哪些文件是本地新增尚未添加到版本库等。

   图12还显示出一个隐藏的目录 ".svn"，在工作区的每一个子目录下都存在这个 ".svn" 目录，注意不要擅自改动该目录下的内容，更不能删除该目录。

   

   图12：检出后的本地工作区

5. 图13显示的是工作区文件修改后，文件、目录图标的变化。

   

   图13：工作区文件改动后图标的改变

3.3   文件提交

在工作区中对文件进行了修改、增、删等操作后，如果想将改动更新至远程服务器，需要执行提交操作。

1. 选择通过右键菜单中的提交动作，如图14所示。

   

   图14：右键菜单中的提交

2. 默认只有修改或其他已经被TSVN标识的文件被提交。如图15所示，本地新增和删除的文件因为尚未标识，缺省不进行提交。

   

   图15：提交对话框

3. 选择本地删除的文件，通过右键菜单标记为删除，如图16所示。

   

   图16：将本地删除的文件标记为删除。

4. 选择本地新增的文件，通过右键菜单标记为新增，如图17所示。

   

   图17：将本地添加的文件标记为新增。

5. 不要忘了撰写提交说明，如图18所示。

   提交说明可以：为什么要修改这些文件，为什么要这么改，以及解决了什么问题，如有可能把相应的Bug编号也写上。

   注意因为提交本身会自动记录谁、在什么时间、修改了哪些文件，因此这类信息没有必要放在提交说明中，以免造成不必要的重复。

   

   图18：撰写提交说明，点击提交按钮

3.4   提交日志

在提交日志中可以看到包括最新提交在内的历次提交记录，点击右键菜单的中的”显示日志“即可。

图19：提交日志

3.5   反删除文件

文件检入到版本库中便被永久记录，即使用户在客户端删除文件并提交，也只是在版本库最新提交中去掉了该文件，但在历史提交中文件仍然存在。SVN提供了恢复被删除文件的功能，用TSVN操作非常的简单。

1. 在工作区进入到浏览提交日志的界面，找到删除文件的提交，右键点击被删除的文件弹出菜单中有”复原此版本作出的修改“一项，如图20所示。

   

   图20：从工作区进入到浏览提交日志的界面

2. 当点击”复原此版本作出的修改“后，TSVN弹出确认对话框，如图21所示。

   

   图21：确认文件恢复的对话框

3. 显示反删除的过程，如图22所示。

   

   图22：反删除过程显示

4. 经过上面操作后，曾经被删除的文件被找回，重新出现在工作区中。图23显示找回的文件的图标叠加了一个加号。

   

   图23：曾经的删除文件被找回

5. 反删除的最后一步就是执行提交，将反删除的文件提交到服务器上，这样才真正完成文件的反删除。

   

   图24：提交完成文件反删除