SVN客户端使用手册

1、SVN客户端使用手册200708231 文档目的本手册意在说明在日常工作或软件开发过程中，如何使用SVN来进行文档版本的控制及与他们协同工作。2 目标读者IT软件开发部全体员工参与IT软件开发部所负责项目的其他人员3 模拟环境现假设有一项目名为：test服务端版本库：testtest开发人员：devA，devBtest有子目录public和private两个子目录并分别有doc、soc和deva、devb两个子目录，即版本库目录结构： test public（公共目录） private（私人目录） doc soc deva devb4 基本操作4.1 安装客户端下载TortoiseSVN-安装

2、程序，双击直接安装即可。安装成功后，在桌面空白处单击鼠标右键，弹出右键菜单会多出两个选项，分别是SVN checkout和Tortoise SVN。如下图：4.2 建立工作区在项目或某项工作开始之前，需首先在本地硬盘上创建一个工作目录，工作目录的名称随意，此处用workspace。4.3 下载版本库现假设devA具有test项目的所有权限，则他就可将本地的workspace目录配置为与test目录匹配，具体做法是：在workspace文件夹上，单击鼠标右键。选择SVN checkout，会出现如下窗口图 1在URL of repository中输入版本库地址，test，在Checkout di

3、rectory中系统会自动添加第二步所创建的工作区目录。在Revision中，选中HEAD revision，这样将会下载到版本库的最新版本。如果想下载库中的旧版本文件，可选中Revision，然后填入版本号即可。如果不想下载整个版本库，而是只想下载自己负责的那部分模块，可以在URL后添加模块名，例如test/private/deva。单击OK。如果有弹出窗要求输入用户名和密码，请输入SVN管理员提供的您的用户名与密码。若假设devB只具有该项目下的public(公共目录)下的所有权限以及private/devB下的所有权限，则应在第二步中的workspace下再创建两个子目录public和d

4、evb，因此，workspace/public与test/public匹配workspace/private/devb与test/private/devb匹配只要分别做一次“SVN Checkout”即可。如图： 上述操作若执行正确，则与SVN匹配的目录上会有绿色的勾出现。如：或，其下的文件或子目录也会带有绿色的勾。同时，若再次在该目录上再次单击鼠标右键，会发现右键菜单已发生变化，“SVN Checkout”选项消失了，并多出了“SVN Update”和“SVN Commit”选项。如图：4.4 提交工作结果如果对本地工作目录中的某一个文件进行了修改，系统会自动为这个文件和这个文件所在的各级父

5、文件夹加上红色叹号，代表该文件或目录已经在本地被修改，如图当所有对版本库的修改操作完毕后，右键单击工作区文件夹，选择“SVN Commit”提交新版本，输入密码后系统将把修改后的版本库上传到服务端，即完成一次对版本库的更新。提交后，红色感叹号会恢复成绿色的勾。切记：新版本提交之后，其他拥有写权限的用户也许会重复以上几步的操作，完成对版本库的再一次更新。所以，每次在工作区文件夹下修改本地版本库之前，必须首先对本地版本库执行一次更新（右键单击工作区，选择“SVN Update”），将最新的版本下载到本地，然后再进行修改操作。5 高级操作在日常的软件开发过程中，除了以上介绍的下载，提交，更新操作外，

6、还有另外几种常用操作。5.1 比较文件的不同之处 当对文件做了修改之后，文件会出现红色叹号，表示已经修改，如果想查看修改后的文件与修改前有何不同，可以右键单击此文件，选择Diff，如图：对于一般文本文件（比如JAVA源程序），系统会弹出一个窗口，窗口分为两个部分，左边为更改之前的版本，右边为更改之后的版本，并在不同之处作出标记和说明。如图：如果是word文档的话，选择Diff之后，系统会打开一个word文档，并在其中以Word修订的形式标出修改后的版本与修改前有何不同。如图：5.2 查看日志 如果想查看一个文件的日志，右键单击这个文件，选择show log，系统会弹出一个窗口，并在窗口中显示该

7、文件的各个版本的log。5.3 查看版本树 如果想查看文件的版本树，右键单击该文件，选择Revision graph，系统将会打开一个窗口，并在窗口中显示该文件的版本树。如图：图6 5.4 下载某个文件的旧版本 如果想要得到某个文件的旧版本，只需在该文件上单击右键，选择Updata to revision即可。系统会提示输入版本号。例如要下载上述文档的1479版本，只需填入1479即可。如下图。查看完版本1479的内容后，如果想再次回到最新版本，只需要对该文档执行“SVN Update”即可。5.5 重名名和删除文件 如果要删除一个文件或重名名一个文件，注意：不要在windows下直接操作。只

8、需右键单击该文件，选择SVN菜单的Rename或Delete，SVN系统便会完成操作。 在workspace中将文件重命名或删除后，服务端的文件结构不会变化，只有当提交新版本库后，即执行“SVN Commit”后，服务端的文件结构才会被更新。 如果误删除了文件，在没有提交版本库之前，可以通过在该目录下空白处单击鼠标右键执行“SVN Update”将文件重新下载到本地的工作目录，也可以通过revert恢复（参考第八条）。如果文件删除，并且已经提交，那么要找回文件只能通过下载旧版本库来完成，参考（4）。注意：在做任何恢复前，必须把本次已修改但不想恢复的文件先单独做一次提交。5.6 创建分支 版本库

9、中最初的文件都是主干文件。如果想要为某个文件创建一个分支，只需右键单击，选择Branch/Tag，系统会弹出一个窗口，在窗口中，From URL表示要创建的这个分支的原始文件（不能修改）。在To URL中，一定要更改一下文件名，如在文件名后加一个标志即可，例如“_branch”，路径不需要更改。在Creat copy in the repository from中，一般选第一个选项即可，即从数据库中最新的版本复制。最后填写日志，选择OK。如图：分支创建完毕，执行“SVN Update”版本库，系统会将主干文件和分支文件同时下载到本地目录，然后即可在分支文件上进行操作。5.7 合并分支当需要把分

10、支文件合并到主干文件时，右键单击主干文件，选择Merge，会弹出一个窗口，如图：在From输入框中填入主干的URL，在To输入框中填入分支的URL（之前要先把“Use From URL”的勾去掉）。在From和To中，都有两个选项HEAD Revision和Revision，表示要进行合并的是哪个版本，一般选HEAD Revision即可。合并之后主干文件会标注红色叹号，表示已被修改，并可以提交。如果合并后文件标注的是黄色感叹号，表示文件有冲突，处理方法见第6章“异常处理”。5.8 撤销修改当对一个文件进行了修改并保存后（注意此处并没有进行提交），如果对修改不满意，想要重新修改，可以右键单击修

11、改过的文件（带红色叹号的那个），然后选择revert，前面的一系列修改便会被撤销，恢复到Update之后的状态。如果一个文件被误删除，也可通过右键单击该文件所在的目录，选择revert来恢复（注意，如此操作会影响到该目录下的所有文件）。6 异常处理此处所说的异常主要是指文件发生冲突。以用户devA和用户devB为例，当两个用户同时下载了最新的版本库，并对库中同一个文件test进行修改提交时，首先提交的用户devA不会发生异常，第二个提交的用户devB便会出现无法提交的现象。因为服务端的版本库已经被devA更新，devB用户在Commit时，系统会提示出错。出错信息如：Modified D:戴I

12、T部工作20070312：质量控制功能区SVN使用workspacepublictest.txtErrorCommit failed(details follow):ErrorYour file or directory test.txt is probably out-of-dateErrorThe version resource does not correspond to the resource with the transaction. 在这种情况下，devB用户需要首先对修改的文件进行Update文件操作。如果两个用户修改了test.txt文件的同一个地方，则在devB用户执行Update后，系统会将本地的test.txt与从服务端下载test.txt合并到一个文件上，并在该文件图标上标上黄色叹号，表示文件出冲突。在文件中通过“<<<<<<”和“>>>>>>”标识冲突位置和冲突内容。devB用户只有与devA协商，将该冲突手工处理，之后单击右键，选择Resolve，冲突标记消除，才能够再次提交，否则无法