TortoiseSVN客户端入门使用教程

一直觉得，TortoiseSVN客户端使用很方便。当新员工入职后，总是要讲解一番基本操作。写了一个文档，介绍常用命令，这样一来新同事可以随时查找，另一方面，我也可以抽出时间来做其它事情。后期还是会陆续更新文档，毕竟使用过程是一个长期的过程，因为总是会提出新需求。

 

 

目录

1概述...1

2安装...1

3操作...2

3.1SVN Checkout…..2

3.2SVN Commit…..3

3.3SVN Update.4

3.4Diff5

3.5Edit conflicts.6

3.6其它命令...8

4目录规范...8

 

1概述

        TortoiseSVN（以下简称“SVN”）是一款版本控制软件。

        特点：

Ø 所有成员维护同一个版本库，无需专人维护所有文件的最新版本;

Ø 协同工作，提高团队工作效率;

Ø 记录每个文件从诞生到最终完成全过程的每步细节，细度由提交人掌控；

Ø 可重用以前的劳动成果；

Ø 能及时了解团队中其他成员的进度;

Ø 资料共享。

2安装

        地址：http://tortoisesvn.net/downloads.html

版本：TortoiseSVN 32-Bit或TortoiseSVN 32-Bit，对应Windows32位或64位版本

包名：TortoiseSVN-1.7.4.22459-win32-svn-1.7.2.msi

安装：按提示安装软件

3操作

3.1SVN Checkout…

        该命令的操作步骤依次如下所示：

Ø 本地创建一个文件夹，在文件夹上点击右键，出现下图所示的菜单项：

Ø 点击“SVN Checkout…”，出现下图所示对话框：

Ø 在“URL of repository：”中填写服务器上的版本文件地址

Ø 在“Checkout directory：”中填写本地文件路径，用于保存从服务器上的版本文件副本（以下简称“副本”），其它选项为默认值

Ø 点击“OK”按钮，出现授权登陆框：

                  向SVN管理员获取账号和密码，输入账号和密码，勾选“Save authentication”（勾选该项后，下次就不用输入账号和密码了），点击“OK”。

Ø 授权通过后，将出现下载服务器版本文件过程的对话框：

Ø 完成数据下载，出现如下界面：

Ø 点击“OK”后，此时在本地文件夹中就会保留服务器文件副本。

到此，通过“SVN Checkout…”，已成功获得所需版本文件副本。

3.2SVN Commit…

注意：在进行该命令之前，必须依次进行其它两个命令操作“SVN Update”和“Diff”（详见命令操作规范）。

副本修改后，文件图标由“绿勾”变成“红叹号”。同时，该副本需上传服务器，保证数据同步，以便其他成员能看到您所修改的数据。

操作步骤依次如下所示：

Ø 找到副本修改处，或所有修改副本的同一个上级目录

Ø 点击鼠标右键，出现如图所示菜单：

Ø 点击“SVN Commit…”，出现如图所示对话框：

该对话框展示内容如下：

（1）      Commit to：表示服务器版本地址，副本会上传到该地址所在的地方，不可编辑；

（2）      Message：用来描述副本修改的原因；

（3）      Changes made：表示当前文件夹下所修改的副本文件。

Ø 点击“OK”，上传服务器，同步版本；

Ø 上传成功后，显示如下对话框：

 

Ø 点击“OK”，上传修改副本成功。

3.3SVN Update

        注意：每当执行“SVN Commit…”时，必须先执行“SVN Update”。

执行该命令，用于同步服务器最新版本，便于在最新版本上开展工作。

操作步骤如下所示：

Ø 找到“Checkout”的根目录，点击右键，出现如下所示菜单：

Ø 点击“SVN Update”，将出现以下对话框：

表示将从服务器下载最新的副本，对话框中所显示的内容表明有两个文件更新。

Ø 点击“OK”，关闭对话框。

到此，通过“SVN Update”，成功获得最新副本。若服务器没有文件更新，则对话框中不会显示“Updated”项，仅显示“Completed”项。

3.4Diff

        注意：每当执行“SVN Commit…”时，最好先执行一下“Diff”。

        目的：再次集中审查副本修改的内容，确保修改无错。

Ø 定位到文件图标为“红叹号”的文件，点击“右键”->“TortoiseSVN”->“Diff”，如下图所示：

Ø 在点击“Diff”之后，出现如下所示对话框：

其中：对话框中左侧部分为服务器上的文件内容，右侧部分为修改后的文件内容。

从左右对比来看，副本的修改内容为“黄色”条状部分。

3.5Edit conflicts

        当副本修改处和服务器版本相同处被修改并下载到本地时，就会发生文件冲突。

        操作步骤如下所示：

Ø 执行“SVN Update”

Ø 若发生冲突，会出现如下对话框：

冲突部分的描述由“红色”字体表示，表示“stdafx.h”文件发生冲突

Ø 在“Conflicted”项指定的文件路径的同级目录下，会出现三个标有“问号”的文件和一个标有“黄色叹号”的文件，它们分别为：stdaf.h，stdaf.h.mine，stdaf.h.r7505，stdaf.h.r7507。

Ø 在“stdafx.h”上点击“右键”->“TortoiseSVN”->“Edit conflicts”

Ø 点击“Edit conflicts”，出现以下对话框：

其中：左边为服务器上修改后的内容部分，右边为副本修改后的内容部分。

Ø 两边的红色部分，根据实际需要进行保存或舍弃。

点击右边“红色”条，如图所示：

由于：左右两边的数据都需要保留，因此执行“Use text block from ’theirs’ before ‘mine’”或“Use text block from ’mine’ before ‘theirs’”。

Ø 点击“Use text block from ’theirs’ before ‘mine’”后，出现如下对话框：

此时就没有“红色”条块了，原先的两个“红色”条块所对应的内容就会合并到下面的对话框中。

Ø 点击“菜单”中画红圈的按钮（Mark as resolved），确认冲突编辑完成：

                此时：stdaf.h.mine，stdaf.h.r7505，stdaf.h.r7507三个文件就会自动删除，stdaf.h文件上的图标由“黄色叹号”变成“红色叹号”。

到此，通过“Edit conflicts”，成功完成冲突编辑操作。

     3.6其它命令

        TortoiseSVN客户端的常用操作主要涉及到以上5个命令，其它命令请读者自己查找相关资料。