TortoiseSVN 能够运行在 Windows Vista 或更高版本，并且提供32位与64位系统的支持。适用与64位 Windows 系统的安装程序同时包含32位的拓展部件。这意味着您无需单独安装32位版本的 TortoiseSVN 就可以在32位的应用程序中使用右键菜单和图标重载。

自 1.2.0 版起放弃对 Windows 98， Windows ME 和 Windows NT 4 的支持。自 1.7.0 版起放弃对 Windows 2000 和 XP SP2 的支持。自 1.9.0 版起放弃对Windows XP SP3的支持。如果需要，仍然可以下载、安装旧版本。

TortoiseSVN 以简单易用的安装包的形式发布。双击安装文件并按照提示操作。安装文件会照顾其余的事情。安装结束后不要忘记重启电脑。

TortoiseSVN 提供语言补丁(Language pack)，它可以将用户界面翻译成多种文字。请查看 附录 G, 语言包和拼写检查器 获得更多关于安装语言补丁的信息。

如果您在安装TortoiseSVN期间或之后遇到任何问题，请参阅我们的在线常见问题解答： https://tortoisesvn.net/faq.html.

对于一个实际的项目，需要在一个安全的地方创建版本库并设置 Subversion 服务器来控制它。而对于本教程而言，我们将会使用 Subversion 的本机版本库功能，该特性使得用户可以直接访问本机硬盘上的版本库而不需要服务器。

首先在您的个人计算机上建立一个新的空目录。这个目录可以建立在任何位置，不过在这一教程中，我们将建立 C:\svn_repos 。现在，你可以右键点击这个新文件夹，从右键菜单中选择 TortoiseSVN → 在这里创建版本库... 。这样做之后，一个可以供您所用的版本库就在这个文件夹中创建好了。我们还可以通过点击 创建目录结构 来创建标准目录结构。

我们有一个版本库，但它现在完全是空的。假设我想要添加一些文件到C:\Projects\Widget1，在文件资源管理器中导航到Widget1并单击右键，选择 TortoiseSVN → 导入...弹出导入对话框

图 1.2. 导入对话框

，输入版本库URL，可以是互联网上任何特定的版本库。既然这样，我们也可以指向本地版本库，如file:///c:/svn_repos/trunk,并添加项目名称Widget1。请注意，file: 协议后面始终有三个斜杠。

这个对话框中另一个重要的功能就是导入信息文本框，你可以输入一段信息来描述你的操作。当你查看项目的历史时，这些提交信息是记录了你修改什么和为什么修改的宝贵资料。在这个例子中，我们可以简单的写一下，例如“导入 Widget1 项目”。点击确定，文件夹就加入到版本库中了。

现在，你创建好了你的版本库，这时，还需要创建一个工作副本用于你平时编写代码。注意，当你把一个文件夹导入到版本库这个过程并不能使刚才的文件夹变成一个工作副本。

你会注意到，这个文件夹看起来与我们原来的文件夹不一样。每一个文件的左下角都有一个绿色的对钩。它们就是只出现在工作副本中的 TortoiseSVN 状态图标。绿色的图标表示文件未被修改，和版本库中的文件版本一致。

该工作了。在 Widget1-Dev 文件夹中，我们开始编辑文件 - 假设我们对 Widget1.c 和 ReadMe.txt 做出了一些修改。注意这些文件的图标上的小图标变成了红色，这说明本地文件已经被修改了。

但是我们做了哪些更改？右键单击任意一个修改过的文件然后选择 TortoiseSVN → 比较差异。启动 TortoiseSVN 的文件比较工具，准确地显示哪些行被修改了。

图 1.3. 文件差异查看器

好的，我们对这些更改很满意，让我们更新版本库。这个动作叫 提交 更改。右键单击文件夹 Widget1-Dev 然后选择 TortoiseSVN → 提交。提交对话框列出了修改过的文件，每一个都有一个复选框。你可以选中列表中的部分文件，但在这个例子中我们将要提交全部修改过文件。输入一段信息来描述做了什么修改然后单击 确定。进度对话框显示被上传到版本库中的文件并且完成提交。

随着项目的发展，需要添加新文件 - 例如说你要添加新功能，有了新文件 Extras.c 还要在现有的文件 Makefile 中加入起对该文件的引用。右键单击文件夹然后选择 TortoiseSVN → 增加。 加入对话框显示了所有未被版本控制的文件，你可以选择哪些文件要被添加。另一个增加文件的方法是右键单击文件自身然后选择 TortoiseSVN → 加入。

现在当你提交文件夹时，新文件会显示为增加，原有的文件显示为修改。注意你可以双击修改的文件查看做了哪些改动。

日志对话框是TortoiseSVN 最有用的功能之一。它把你所有的文件/文件夹提交记录显示为一个列表，并且显示你输入的详细提交信息（你按照建议输入提交信息了吗？如果没有，现在知道多重要了吧）。

图 1.4. 日志对话框

好吧，我在这儿偷个懒，用一张TortoiseSVN 版本库的截图。

对话框的上部显示提交的版本列表以及提交信息的开头。如果选中版本列表中的任意一个，对话框的中部显示该版本完整的日志消息，对话框的底部显示更改的文件和文件夹列表。

对话框的每一部分都有右键菜单提供很多使用这些信息的方法。在底部可以 双击 文件来完整的查看该版本所做的修改。参阅 “版本日志对话框”一节 获得完整的内容。

所有的版本控制系统都有的功能就是让你可以撤销之前做的更改。如你预料的一样，TortoiseSVN 非常容易做到这一点。

如果你想抛弃还没有提交的更改并将文件复原到修改之前的状态，TortoiseSVN → SVN 还原 就是你的好伙伴。它抛弃了所做的更改(扔到回收站里)并复原到修改之前的版本。如果你想抛弃更改的一部分，可以使用 TortoiseMerge 来查看区别并有选择的复原被修改的文件行。

如果你要撤销某一个特定版本的影响，启动日志对话框，找到不想要的版本。选择 右键菜单 → 复原此版本作出的修改 然后这些更改就会被撤销。

考虑这个情景，我们有两个共同工作者，Harry 和 Sally，他们想同时编辑版本库里的同一个文件，如果首先 Harry 保存它的修改，过了一会，Sally 可能凑巧用自己的版本覆盖了这些文件，Harry 的更改不会永远消失(因为系统记录了每次修改)，Harry 所有的修改不会出现在 Sally 的文件中，所以 Harry 的工作还是丢失了—至少是从最新的版本中丢失了—而且是意外的，这就是我们要明确避免的情况！

图 2.2. 需要避免的问题

许多版本控系统使用 锁定-修改-解锁 模型来解决这个问题，这是一个简单的解决方案。在这种系统中，在同一时间版本库只允许一个用户修改一个文件。首先，Harry 必须在修改前 锁定 该文件。锁定文件有点像从图书馆借书；如果 Harry 锁定了一个文件，那么 Sally 就无法修改该文件。如果她试图锁定该文件，版本库会拒绝这个请求。她只能读取这个文件，并等待 Harry 结束修改并释放文件锁。在 Harry 解锁文件后，他的“回合”就结束了，现在 Sally 可以接手工作 - 锁定并编辑文件。

图 2.3. 锁定-修改-解锁 方案

锁定-修改-解锁模型有一点问题就是限制太多，经常会成为用户的障碍:

Subversion、CVS和其他的一些版本控制系统使用复制-修改-解锁模型作为变相的锁定方式。在这种模型下，每个用户的客户端会读取版本库内容，而后针对文件或者项目创建独属于单个用户的工作副本。用户接下来会平行地工作，修改他们的独属副本。最后，这些独属副本会上传并合并为全新的、最终的版本。版本控制系统会协助处理这项合并工作，但最终版的正确成型仍需人类负责。

这儿有一个例子。比如说 Harry 和 Sally 参加同一个项目每人都有各自的工作副本，从同一个版本库复制出来的。他们同时工作，在自己的副本中修改同一个文件 A。Sally 先将她的更改保存到版本库中。 稍后，当 Harry 尝试提交他的更改时，版本库提示他的文件 A 已经过时。换句话说，自从他上次复制文件后，无论如何版本库中的文件 A 已经被修改了。所以 Harry 要用客户端程序将版本库中文件 A 的新更改 合并 到他的工作副本中。碰巧的是 Sally 的更改和他的不重合; 所以一旦他整合了两人的更改，他就可以把他的工作副本复制回版本库。

图 2.4. 复制-修改-合并 方案

图 2.5. 复制-修改-合并 方案(续)

但是如果 Sally 和 Harry 的修改重叠了该怎么办？这种情况叫做冲突，这通常不是个大问题，当 Harry 告诉他的客户端去合并版本库的最新修改到自己的工作副本时，他的文件 A 就会处于冲突状态: 他可以看到一对冲突的修改集，并手工的选择保留一组修改。需要注意的是软件不能自动的解决冲突，只有人可以理解并作出智能的选择，一旦 Harry 手工的解决了冲突(也许需要与 Sally 讨论)，他就可以安全的把合并的文件保存到版本库。

复制-修改-合并模型感觉是有一点混乱，但在实践中，通常运行的很平稳，用户可以并行的工作，不必等待别人，当工作在同一个文件上时，也很少会有重叠发生，冲突并不频繁，处理冲突的时间远比等待解锁花费的时间少。

最后，一切都要归结到一条重要的因素: 用户交流。当用户交流贫乏，语法和语义的冲突就会增加，没有系统可以强制用户完美的交流，没有系统可以检测语义上的冲突，所以没有任何证据能够承诺锁定系统可以防止冲突，实践中，锁定除了约束了生产力，并没有做什么事。

有一种情况下锁定-修改-解锁模型会更好，也就是你有不可合并的文件，例如你的版本库包含了图片，两个人同时编辑这个文件，没有办法将这两个修改合并，Harry 或 Sally 会丢失他们的修改。

Subversion 缺省使用复制-修改-合并模型，大多数情况下可以满足你的需求。然而，Subversion 1.2 后还是支持锁定，如果你有不可合并的文件，或者你只是想实行强制管理策略，Subversion 仍然会提供你需要的特性。

你已经阅读过了关于工作副本的内容，现在我们要讲一讲客户端怎样建立和使用它。

一个 Subversion 工作副本是你本地机器一个普通的目录，保存着一些文件，你可以任意的编辑文件，而且如果是源代码文件，你可以像平常一样编译，你的工作副本是你的私有工作区，在你明确的做了特定操作之前，Subversion 不会把你的修改与其他人的合并，也不会把你的修改展示给别人。

当对工作副本中的文件做了一些更改并确认他们能够正常工作后，Subversion 提供将这些更改公布给同项目的其他人员的命令(通过写入版本库)。如果其他人公布他们的更改，Subversion 提供将这些更改合并到工作副本的命令(通过读取本版本库)。

Subversion还会在工作副本中创建并管理一些额外的文件，这些文件将用于协助执行命令。特别地，你的工作副本中会包含一个名为.svn的子目录，即该工作副本的管理目录。管理目录中的文件帮助Subversion识别哪些文件包含未发布的更改，哪些文件由于他人的更改已过期。早于1.7版本的Subversion会在工作副本中每一级目录下包含名为.svn的管理子目录。1.7版本开始， Subversion 启用了全新的策略：每个工作副本只有一个管理子目录，该目录是工作副本根目录的直接子级。

一个典型的 Subversion 的版本库经常包含许多项目的文件(或者说源代码)，通常每一个项目都是版本库的子目录，在这种安排下，一个用户的工作副本往往对应版本库的的一个子目录。

举一个例子，你的版本库包含两个软件项目。

图 2.6. 版本库的文件系统

换句话说，版本库的根目录包含两个子目录: paint 和 calc。

要获得工作副本，必须通过 检出 版本库中的某个子树。(术语 检出 听起来好像会锁定和保留资源，但实际上不是这样; 它只是给项目创建了一个私有的副本。)

假设你对button.c做出了修改。由于.svn目录记录了文件的修改日期和原始内容，Subversion得以告知使用者已经更改了这个文件。然而， Subversion 并不会将你的更改展示给全部用户，除非你明确指出要这么做。推送你做出的更改这一举动通常被称作提交修改（或者检入修改）到版本库。

发布你的修改给别人，可以使用 Subversion 的提交命令。

这时你对 button.c 的修改已经提交到了版本库，如果其他人取出了 /calc 的一个工作副本，他们会看到这个文件最新的版本。

设你有个合作者，Sally，她和你同时取出了 /calc 的一个工作副本，你提交了你对 button.c 的修改，Sally 的工作副本并没有改变，Subversion 只在用户要求的时候才改变工作副本。

要使项目最新，Sally 可以要求 Subversion 更新她的工作副本，通过使用更新命令，可以将你和所有其他人在她上次更新之后的修改合并到她的工作副本。

注意，Sally 不必指定要更新的文件，Subversion 利用 .svn 以及版本库的进一步信息决定哪些文件需要更新。

Subversion 可以通过多种方式访问－本地磁盘访问，或各种各样不同的网络协议，但一个版本库地址永远都是一个 URL，URL 方案反映了访问方法。

对于大多数情况，Subversion 的 URL 使用标准格式，允许服务器名称和端口作为 URL 的一部分明确的指出来。files:// 访问方式一般用于本地访问，尽管它可以使用 UNC 路径来引用网络主机。因此 URL 使用这种格式 file://hostname/path/to/repos。对于本机而言，URL 中的 hostname 部分必须省略或者使用 localhost。就是因为这个原因，本机路径通常含有 3 个斜线，file:///path/to/repos。

同样，在 Windows 平台上使用 file:// 方案的用户需要使用一种非官方的 “标准” 协议格式来访问那些位于本机其他分区，即与客户端当前所处分区不同的版本库。如下两种格式的 URL 路径是有效的，其中X代表版本库目录所在分区的盘符：

file:///X:/path/to/repos
...
file:///X|/path/to/repos
...

注意 URL 使用普通的斜杠，而不是 Windows 本地(非 URL)形式的路径。

你可以通过网络共享访问一个FSFS版本库，但由于很多原因不建议你这样做。

svn commit 操作可以作为一个原子事务操作发布任意数量文件和目录的修改。在你的工作副本中，你可以改变文件内容，创建、删除、改名和复制文件和目录，然后作为一个整体提交。

在版本库中，每次提交被当作一次原子事务操作: 要么所有的改变发生，要么都不发生，Subversion 努力保持原子性以应对程序错误、系统错误、网络问题和其他用户行为。

每当版本库接受了一个提交，文件系统进入了一个新的状态，叫做版本，每个版本被赋予一个独一无二的自然数，一个比一个大，初始修订号是 0，只创建了一个空目录，没有任何内容。

可以形象的把版本库看作一系列树，想象有一组版本号，从 0 开始，从左到右，每一个修订号有一个目录树挂在它下面，每一个树好像是一次提交后的版本库“快照”。

图 2.7. 版本库

需要特别注意的是，工作副本并不一定对应版本库中的单一版本，他们可能包含多个版本的文件。举个例子，你从版本库检出一个工作副本，最新的版本是 4:

calc/Makefile:4
integer.c:4
button.c:4
      

此刻，工作目录与版本库的版本 4 完全对应，然而，你修改了 button.c 并且提交之后，假设没有别的提交出现，你的提交会在版本库建立版本 5，你的工作副本会是这个样子的:

calc/Makefile:4
integer.c:4
button.c:5
      

假设此刻，Sally 提交了对 integer.c 的修改，建立修订版本 6，如果你使用 svn update 来更新你的工作副本，你会看到:

calc/Makefile:6
integer.c:6
button.c:6
      

Sally 对 integer.c 的改变会出现在你的工作副本，你对 button.c 的改变还在，在这个例子里，Makefile 在 4、5、6 版本都是一样的，但是 Subversion 会把 Makefile 的版本设为 6 来表明它是最新的，所以你在工作副本顶级目录作一次干净的更新，会使所有内容对应版本库的同一修订版本。

对于工作副本的每一个文件，Subversion 在管理目录 .svn/ 记录两项关键的信息:

给定这些信息，通过与版本库通讯，Subversion 可以告诉我们工作文件是处与如下四种状态的那一种:

现在你在D:\SVN\MyNewRepository创建了一个新的版本库。

为了访问本地版本库，你需要这个文件夹的路径，只要记住Subversion期望所有的版本库路径使用的形式为file:///C:/SVNRepository/，请注意全部使用的是斜杠。

为了访问网络共享中的版本库，你可以使用驱动器影射或使用UNC路径，对于UNC路径，形式为file://ServerName/path/to/repos/，请注意这里前面只有两个斜杠。

在SVN 1.2之前，UNC路径曾经是一种非常晦涩的格式file:///\ServerName/path/to/repos，这种格式依然支持，但不推荐。

尽管从理论上说，将一个 FSFS 格式的版本库放在网络中共享，并且多用户通过 file:// 协议访问是可行的。但是我们不推荐这样做。事实上我们强烈反对这样做，并且不支持这样的用法基于不同得原因：

file:// 访问是为本机工作而准备的，只能单用户访问，特别是测试和调试。当你打算共享版本库的时候，你真的需要设置一个适当的服务器，而且它并不像你想象的那样困难。阅读“访问版本库”一节获得选择指南，并配置服务器。

在将你的数据导入到版本库之前，首先你得考虑如何组织你的数据。如果你使用一种推荐的布局，你在后面的操作将会更容易许多。

有一些标准的，推荐使用的组织版本库结构的方法。大多数人创建一个 trunk 目录掌管开发的 “主干”，一个 branches 目录存放分支副本，以及一个 tags 目录存放标记副本。如果一个版本库只掌管一个项目，那么人们通常创建这些顶级目录：

/trunk
/branches
/tags
    

因为这个布局非常通用，所以当使用 TortoiseSVN 创建版本库时，它会提出帮你创建这个目录结构。

如果一个版本库包含多个项目，人们通常按分支来安排布局:

/trunk/paint
/trunk/calc
/branches/paint
/branches/calc
/tags/paint
/tags/calc
    

……或者按项目:

/paint/trunk
/paint/branches
/paint/tags
/calc/trunk
/calc/branches
/calc/tags
    

如果项目不是密切相关，而且每一个是单独被检出，那么按项目布局是合理的。对于那些你想一次检出所有项目，或需要将它们打成一个分发包的相关项目，按分支来布局通常比较好。这种方式你只要检出一个分支，而且子项目之间的关系也比较清楚。

如果你采用顶层/trunk /tags /branches这种方式，并不意味着你必须复制整个主线为分支或标签，而且某些情况下这种结构更具灵活性。

对于不相关的项目，你可能更愿意使用不同的版本库。当你提交时，改变的是整个版本库的修订号，而不是项目的。让两个不相关的项目共用一个版本库，会导致修订号出现较大的跳跃。Subversion和TortoiseSVN项目看起来是在同一个主机地址，但是它们是在完全独立的版本库中开发着，并且版本号也不相干。

当然，你完全可以不理会上面提及的通用布局。你可以自由改变，来满足你和你团队的需要。请记住，不管你选择哪种布局，它都不是永久的。你可以在随时重新组织你的版本库。因为分支和标签是普通的目录，只要你愿意，TortoiseSVN 可以将它们移动或重命名。

从一种布局转换到另一种布局仅仅是在服务器端移动一些文件或目录；如果你不喜欢版本库的组织形式，仅管大胆地修改那些目录。

因此，如果你还没有在版本库中创建基本的文件夹结构，你应该立刻创建。创建文件夹有 2 种方法。如果你只想创建一个 /trunk /tags /branches 结构，你可以使用版本库浏览器创建这 3 个文件夹(独立的 3 次提交)。如果你想创建一个层次更深的结构，那么更简单的做法是先在硬盘中创建好文件夹结构，然后将其导入(只有 1 次提交)，就像这样：

请注意你导入的文件夹名不会显示在版本库中，只有文件夹的内容。例如，创建如下文件夹结构

C:\Temp\New\trunk
C:\Temp\New\branches
C:\Temp\New\tags

导入C:\Temp\New的版本库根目录，之后应该像这样：

/trunk
/branches
/tags

图 4.1. 显示重载图标的资源管理器

TortoiseSVN 最明显的特性之一就是图标重载，重载的图标显示在你的工作副本文件上。你一眼就可以看到文件被修改过了。参考 “图标重载”一节 查阅不同的重载图标含义。

图 4.2. 版本控制下一个目录的右键菜单

所有的TortoiseSVN命令都是通过windows资源管理器的右键菜单执行。右键点击一个文件或者文件夹，大多数菜单项都能够直接显示。一个命令是否显示取决于这个文件或文件夹或者它们的父文件夹是否受版本控制，你也可以将TortoiseSVN的菜单作为资源管理器菜单的一部分。

在某些情况下，你可能看到多个TortoiseSVN条目。这不是BUG！

图 4.3. 在一个版本控制的文件夹下资源管理器文件菜单中的快捷方式。

本示例是在一个受控文件夹下的某个未受控的快捷方式， 在资源管理器的文件菜单下有三个TortoiseSVN条目。一个是受控文件夹本身的，一个是快捷方式本身的，第三个是快捷方式所指向的对象。为了帮助你区分它们，菜单条目的图标的右下角有标志，表明是文件、快捷方式、文件夹或是选中了多项。

图 4.4. 版本控制下的一个目录的右键拖拽菜单

在工作副本里右键拖拽文件或目录到新的位置，或者右键拖拽一个非版本控制的文件或文件夹到一个版本控制目录下的时候，右键菜单还能够出现其他的命令。

一些常见的操作与 Windows 的快捷键是一样的，但没有出现在按钮或是菜单中。如果你找不到一些显而易见的操作，比如刷新视图，请参考以下内容。

如果连接的版本库需要密码，就会显示认证对话框。

图 4.5. 认证对话框

输入你的用户名和密码。复选框能让 TortoiseSVN 在 Subversion 的缺省目录: %APPDATA%\Subversion\auth 的三个子目录内保存认证信息:

如果想要清除认证缓存，可以通过 TortoiseSVN 设置对话框的已保存数据页来实现。全部清除按钮会清除所有版本库的认证缓存。清除...按钮会显示一个对话框，你能选择哪些认证缓存需要被清除。清参考“已保存数据的设置”一节

有些人希望在注销 Windows 或者关机时删除认证数据。完成这个的方法是使用关机脚本来删除 %APPDATA%\Subversion\auth 目录，例如:

@echo off
rmdir /s /q "%APPDATA%\Subversion\auth"

关于如何安装这种脚本的详细说明请参阅: http://www.windows-help-central.com/windows-shutdown-script.html。

更多的关于如何设置服务器进行认证和授权控制的信息，请参考: “访问版本库”一节

大多数 TortoiseSVN 的对话框显示很多信息，但是经常只有最大化高度或者宽度有用，而不是全部最大化，覆盖整个屏幕。为了方便，在 最大化 按钮有快捷方式做这些工作。使用鼠标中键最大化高度，右键最大化宽度。

如果将项目导入一个已经含有其它项目的版本库中，那么版本库的结构已经确定了。如果要导入一个新的版本库中，那么最好花点时间来想一下如何设置版本库的结构。阅读 “版本库布局”一节 获得更多建议。

这部分描述了Subversion 导入命令，它被设计用于一次性导入一个文件夹的层次结构到版本库中。尽管它能完成这个工作，但是它还是有不少缺点：

基于此，我们推荐你不要使用导入命令，而是按照“导入适当的位置”一节描述的的两步方法，除非你正在你的版本库创建一个初始的/trunk /tags /branches结构的简单步骤中。既然你做到了这里，这些是基本导入工作的方法：

在将你的项目导入到版本库之前，你应该:

现在进入资源管理器，选择你的项目的顶层目录，右击打开上下文菜单。选择命令TortoiseSVN → 导入 ...，它会弹出一个对话框:

图 4.6. 导入对话框

在这个对话框中，需要输入你需要导入的版本库所在的 URL。，你必须了解非常重要的事项: 你要导入的本地文件夹本身不会出现在版本库中，只有文件夹中的内容。例如，你有这样的文件夹结构:

C:\Projects\Widget\source
C:\Projects\Widget\doc
C:\Projects\Widget\images

你将 C:\Projects\Widget 导入到 http://mydomain.com/svn/trunk，然后你会惊奇的发现: 你的子目录直接进入 trunk 中，而不是在 Widget 的子目录中。你需要将子目录作为 URL 的一部分明确的指出来，http://mydomain.com/svn/trunk/Widget-X。注意，如果版本库中不存在指定的子目录，导入命令将会自动创建它们。

这个输入信息将用作提交日志。

默认情况下，匹配全局忽略模式的文件和文件夹不会被导入。你可以使用包含忽略文件检验栏来禁止此行为。参考“常规设置”一节以获得关于全局忽略模式的更多信息。

当你点击确认时，TortoiseSVN 会导入包含所有文件的完整目录树到版本库。现在这个工程就存贮在版本库，被版本控制。请注意，你导入的文件夹没有被版本控制！你需要检出刚才导入的版本，以便获得受版本控制的工作副本。或者继续阅读，找到如何导入文件夹到合适的位置。

假定你已经有个版本库，你想给它增加一个新目录结构，只需以下步骤:

有时候你需要版本控制一个包含用户专用的数据。它意味着你有一个文件，每个开发者/用户都需要修改，一边满足他/她的本地配置。但是版本控制这样的文件是困难的，因为每个用户可能都要提交他/她的修改。

在这种情况下，我们建议使用模版文件。创建一个包含所有开发者需要的数据的文件，增加到版本库中，让开发者检出。然后，每个开发者创建一个副本，改名此文件。于是，修改这个文件不再是问题。

举个例子，你可以看看TortoiseSVN的构建脚本。它调用一个不在版本库中的TortoiseVars.bat文件 。 只有TortoiseVars.tmpl在版本库中。TortoiseVars.tmpl是一个模版文件，每个开发者都需要用模板创建一个副本，并重命名为TortoiseVars.bat。在这个文件中，我们增加了注释，以便用户根据他们的本地设置，知道那些行他们需要编辑，来让它正常工作。

为了不干扰用户，我们也将default.build.user增加到它父目录的忽略列表，也就是，我们设置了Subversion属性svn:ignore来包含这个文件名称。这样，每次提交时它都不会作为没有版本控制的文件出现。

你可以选择要检出的深度，它允许你指定子目录递归的深度。如果你只需要大目录中的几个子条目，你可以只检出最高层目录，然后递归的更新选择的目录。

为了方便地选择你想要检出地文件并强制目标工作副本只保留这些项目，单击选择项目按钮。这会打开一个新对话框。你可以选中你在工作副本中想要的所有项目，取消选中你不想要的所有项目。目标工作副本将称为所谓的稀疏检出。这种工作副本的更新将不会获取丢失的文件和文件夹，而是单单更新你的工作副本中所拥有的文件。

如果检出了一个稀疏工作副本(例如，在检出深度一栏中选择了除全递归以外的其它项)，你可以方便地使用如下地方式之一来添加或删除子文件夹 。

当你想要检出一个很大的文件树的某些部分而且想要方便的只更新单一的工作副本时，该功能非常有用。假设有一个很大的文件树，其中包含 99 个子文件夹从 Project01 到 Project99，你只想检出 Project03，Project25 和 Project76/SubProj。按下列步骤操作:

如果你的工作副本是最新的，并且没有冲突，你就已经为提交做好准备了，选择你要提交的文件和/或文件夹，然后TortoiseSVN → 提交....

图 4.8. 提交对话框

提交对话框将显示每个被改动过的文件，包括新增的、删除的和未受控的文件。如果你不想改动被提交，只要将该文件的复选框的勾去掉就可以了。如果你要加入未受控的文件，只要勾选该文件把它加入提交列表就可以了。

快速选中或者取消选中所有版本控制的或修改过的文件类型，单击列表上方显示项目的项目链接。

关于颜色和基于项目状态覆盖相关的信息，请参考“本地与远程状态”一节

那些被切换(switched)到不同版本库路径的项也用(s)标记来表示。当工作在分支上的时候你可能切换到某处，然后忘记切换回主干。这是你的警告信号！

在提交对话框中双击任何修改过的文件，将运行外部 diff 工具显示你做的改动。上下文菜单将给你更多的选项，请看屏幕截图。你可以从这里将文件拖动到另一个应用程序中，如文本编辑器或 IDE。

可以通过单击条目左侧的复选框来选中或不选该条目。对于目录，可以按下 Shift 键再 选择 就可以递归该动作。

在底部面板中显示的列是可定制的。如果你右击任何一列的头部，你就会看到一个上下文菜单，允许你选择哪一列要显示。还可以在鼠标移动到列边界时通过拖动手把来改变列的宽度。这些定制的内容都会被保留下来，下一次你会见到相同的列。

缺省情况下，当你成功提交修改后，你在这些文件上持有的锁会被自动释放。如果你需要保留锁，请确认选中检查框保留锁。此检查框的缺省状态从 Subversion 配置文件的 no_unlock 选项获取。参考 “常规设置”一节 以获得更多关于编辑 Subversion 配置文件的信息。

提交对话框支持 Subversion 的更改列表功能来分组相关的文件。关于这个功能，请查看“修改列表”一节。

有时你只想提交一个文件部分修改的部分。这种情况通常在你做某些事情，但是一个紧急的修复需要被提交，而那个修复正好是你正在工作中的同一个文件。

右键文件并使用上下文菜单 → 提交后恢复。这回创建文件的一个副本。然后你可以编辑这个文件，例如在文本编辑器中，撤销你不想要提交的所有修改。在保存这些修改后，你可以提交文件

提交完成后，文件副本会自动恢复，你的文件将保留未提交的所有修改

有时，你经常更改一些版本控制的文件但你却不打算提交它们。这有可能说明你的构建过程中存在瑕疵 - 那些文件为什么是版本控制的？应该使用模版文件吗？但可能这是无法避免的。一个经典的原因是当你每次构建的时候，集成开发环境(IDE)更改了项目文件的时间戳。项目文件是版本控制的，因为它包含全部的构建设置。但是，仅仅因为时间戳更改了的情况下，你并不需要提交它。

为了解决这样一个棘手的问题，我们准备了一个名叫 ignore-on-commit 的更改列表。任何一个被添加到这个列表的文件在提交对话框中将不会自动选中。你仍然可以提交此文件的更改，不过你需要在提交对话框中手动选中它。

确保输入描述你所提交的修改内容的日志信息。这可以帮你回顾做了什么，什么时候做的。信息的内容可长可短，许多项目规定了要包含的内容、使用的语言甚至是严格的格式。

你可以使用与电子邮件相似的约定，简单格式化日志消息。如果对文本采用这些样式，使用*文本*表示粗体，_文本_表示下划线，^文本^表示斜体。

图 4.9. 提交对话框的拼写检查器

TortoiseSVN包含了一个拼写检查器帮助你正确地书写日志信息。对任何错误拼写的词都高亮显示。使用右键菜单可以获得修改建议。当然它不会知道所有的技术术语，所以有时一些拼写正确的词会被当作错误。但不用担心，你可以使用右键菜单将它们加入你的个人字典中。

日志消息窗口同时也含有文件名和函数自动完成的功能。它使用正则表达式从本次提交的(文本)文件中抽取类和函数的名称，以及被提交文件的文件名。如果你输入的单词与列表中的内容匹配(至少键入 3 个字符，或者按 Crtl+空格)，就会显示一个下拉列表让你选择完整的名字。TortoiseSVN 支持的正则表达式位于 TortoiseSVN 安装文件夹下的 bin 文件夹中。你可以自定义匹配规则然后将其保存在文件 %APPDATA%\TortoiseSVN\autolist.txt 中。当然，在升级新版本的 TortoiseSVN 时你个人的自动匹配规则列表不会被覆盖。如果你不熟悉正则表达式，可以看一下介绍:http://zh.wikipedia.org/wiki/%E6%AD%A3%E5%88%99%E8%A1%A8%E8%BE%BE%E5%BC%8F，以及在线文档和教程: http://www.regular-expressions.info/。

写出正确的匹配规则有点棘手，所以为了帮你写出合适的表达式，我们提供了一个对话框，你可以输入表达式，然后输入文件名来做个测试。要启动该对话框，在命令提示符中输入这个命名: TortoiseProc.exe /command:autotexttest。

日志信息窗口里也同样包含了一个提交信息的片段工具。一旦你输入某个片段的快捷指令后他们就会出现在自动完成提示框内。你可以从提示框内选择一个片段这样整个片段的文字就会插入进来。TortoiseSVN自带的片段都被保存在TortoiseSVN安装目录下的bin文件夹内。你也可以在%APPDATA%\TortoiseSVN\snippet.txt里存储你自己的片段。#是注释符，换行符可以用反斜杠标记\n和\r。你还可以通过\\来输入反斜杠。

你可以重复使用先前键入的日志信息。只需要点击最近信息即可查看你为此工作副本键入的最近几条信息。

你可以从 TortoiseSVN 的设置窗口的已保存数据页中清除所有的保存消息，或者你可以在最近信息对话框中使用 Delete 键单独删除某条消息。

如果想要在日志信息中加入选中的文件路径，可以在编辑框中使用 右键菜单 → 粘贴文件名列表。

另一个向日志消息中插入路径的方法是: 从文件列表中将文件拖拽到文本框中。

在按下OK之后，会出现一个对话框显示提交的进度。

图 4.10. 显示提交进度的进度对话框

进度对话框使用颜色代码来高亮显示不同的提交行为。

这是默认的配色方案，但你可以通过设置对话框来定制这些颜色。参考“TortoiseSVN 颜色设置”一节获得详情。

当两名或更多的开发人员修改了某个文件的同一行时就会发生冲突。因为 Subversion 对项目一无所知，所以需要由开发人员来解决冲突。文件中冲突区域按此标记

<<<<<<< filename
your changes
=======
code merged from repository
>>>>>>> revision

对于每一个冲突的文件 Subversion 在目录中添加了三个额外的文件:

你可以用TortoiseSVN → 编辑冲突来运行外部合并工具/冲突编辑器，你也可以使用任何别的编辑器手动解决冲突。你需要决定哪些代码是需要的，做一些必要的修改然后保存。使用诸如TortoiseMerge或者其他流行的合并工具。后者总体上是更简单的选择，因为他们在三窗格面板中显示文件。如果你使用文本编辑器，你需要搜索以<<<<<<<开头的字符串。

然后，执行命令 TortoiseSVN → 已解决 并提交人的修改到版本库。需要注意的是已解决命令并不是真正的解决了冲突，它只是删除了文件 文件名.扩展名.mine 和 文件名.扩展名.r*，允许你提交修改。

如果你的二进制文件有冲突，Subversion不会试图合并文件。本地文件保持不变(完全是你最后修改时的样子)，但你会看到文件名.扩展名.r*文件。如果你要撤消你的修改，保留版本库中的版本，请使用 SVN 还原(Revert)命令。如果你要保持你的版本覆盖版本库中的版本，使用已解决命令，然后提交你的版本。

你可以右击父文件夹，选择TortoiseSVN → 已解决...，使用“已解决”命令来解决多个文件。这个操作会出现一个对话框，列出文件夹下所有有冲突的文件，你可以选择将哪些标记成已解决。

当两名或更多的开发人员修改了某个文件的属性时就会发生属性冲突。属性作为文件的一部分，解决属性冲突只能由开发人员来完成。

如果一个更改必须被另一个覆盖，那么就在 使用本地属性解决 和 使用远程属性解决 中选择一个。如果更改想要被合并，那就选择 手工编辑属性，选出所要的属性值然后标记为已解决。

当一名开发人员移动、重命名、删除一个文件或文件夹，而另一名开发人员也对它们进行了移动、重命名、删除或者仅仅是修改时就会发生树冲突。有很多种不同的情形可以导致树冲突，而且不同的情形需要不同的步骤来解决冲突。

当一个文件通过 Subversion 在本机删除后，文件也从本机文件系统中删除。因此即使它是树冲突的一部分，却既不能显示冲突的叠加图标也不能通过右键单击来解决冲突。使用检查修改对话框来获得编辑冲突选项。

TortoiseSVN 能够协助找到合并更改的正确位置，但是需要作一些额外的工作来整理冲突。请牢记: 当进行一次更新操作后，工作副本的基础文件将会包括每一个项目在执行更新操作时版本库中的版本。如果你在进行更新后再撤销更改，工作副本将返回到版本库的状态，而不是你开始进行更改前的状态。

图 4.12. 显示重载图标的资源管理器

现在你已经从 Subversion 版本库中检出了一份工作副本，你可以在资源管理器中看一下这些文件的图标有什么变化。这也正是 TortoiseSVN 这么流行的原因之一。TortoiseSVN 加入了被称为重载图标的功能重载了原始的文件图标。根据文件的 Subversion 状态的不同，重载的图标也不同。

一个新检出的工作副本使用绿色的对勾做重载。表示 Subversion 状态正常.

在你开始编辑一个文件后，状态就变成了已修改，而图标重载变成了红色感叹号。通过这种方式，你可以很容易地看出哪些文件从你上次更新工作副本后被修改过，需要被提交。

如果在更新的过程中出现了冲突，图标会变成黄色感叹号。

如果你给一个文件设置了svn:needs-lock属性，Subversion 会让此文件只读，直到你获得文件锁。具有这个重载图标的文件来表示你必须在编辑之前先得到锁。

如果你拥有了一个文件的锁，并且 Subversion 状态是正常，这个重载图标就提醒你如果不使用该文件的话应该释放锁，允许别人提交对该文件的修改。

这个图标表示当前文件夹下的某些文件或文件夹已经被调度从版本控制中删除，或是该文件夹下某个受版本控制的文件丢失了。

加号告诉你有一个文件或目录已经被调度加入版本控制。

横条告诉你有一个文件或目录被版本控制系统所忽略。这个图标重载是可选的。

这个图标说明文件和目录未被版本控制，但是也没有被忽略。这个图标重载是可选的。

事实上，你会发现并不是所有的图标被你的系统使用。这是由于 Windows 允许的重载图标数量很有限，如果你同时使用旧版的 TortoiseCVS，就没有足够的重载可用。TortoiseSVN 试图成为一个“良好市民(TM)”，限制自身使用重载图标，为别的程序留下机会。

现在有很多 Tortoise 客户端工具(TortoiseCVS, TortoiseHG, ...)所以图标限制成为一个实实在在的问题。为了解决这个问题，TortoiseSVN 项目引入了一种通用共享图标集，以动态链接库的形式加载。它可以被所有的 Tortoise 客户端工具使用。联系你的客户端程序提供者以确认是否支持这一功能（微笑）。

要获得图表重载与 Subversion 状态的对应关系，或者其它技术细节，请阅读“图标重载”一节。

图 4.13. 资源管理器属性页，Subversion 页面

有时你可能想得到关于一个文件/目录的更多的细节信息而不仅是一个重载的标志。 你能得到Subversion的属性对话框中浏览到的所有信息。只需选择指定文件或目录，然后在文件菜单中选择Windows 菜单 → 属性(注意: 这是资源管理器提供的标准属性菜单，而不是TortoiseSVN 子菜单的其中之一)。在TortoiseSVN 属性对话框中已经为在Subversion控制下的文件/目录增加新的属性页。在这里你能看到所有的关于选择文件/目录的相关信息。

图 4.14. 检查修改

通常知道你修改了哪些文件以及哪些文件已经由另人修改并提交了是很有用的。这就是命令 TortoiseSVN → 检查修改 的用武之地了。这个对话框显示了所有你的工作副本中进行了任何形式的修改的的文件，也包括了当前存在的未受控的文件。

如果单击 检查版本库 就会同时查看版本库中的更改。通过这种方法可以在更新之前检查是否可能发生冲突。你也可以从版本库中只更新选中的文件而无需更新整个文件夹。在默认情况下，检查版本库 按钮只获取位于工作副本深度内的条目的远程状态。如果要查看版本库中所有的文件和文件夹，即使有些文件并没有被检出，那么就应该在单击 检查版本库 按钮时按住 Shift 键。

对话框使用颜色代码来高亮显示状态。

这是默认的配色方案，但你可以通过设置对话框来定制这些颜色。参考“TortoiseSVN 颜色设置”一节获得详情。

图标也被用来指示其他状态。屏幕截图显示了所有可能必要的图标。

图标显示了如下状态：

那些被切换到不同版本库路径的项目也用(s)标记来表示。当在分支上工作的时候你可能切换到某处，然后忘记切换回主干。这是你的警告信号！右键菜单允许你把它们再次切换回普通路径

在对话框的上下文菜单中你可以显示改变的差异。使用 上下文菜单 → 与基础版本比较检查你所作的本地修改。使用上下文菜单 → 使用标准差异格式显示差异检查版本库中别人作的修改。

你也可以还原单个文件的修改。如果不小心删除了某个文件，就会显示为 缺少 而且可以使用 SVN 还原 来恢复它。

可以使用右键菜单 → 删除将未版本控制的或忽略的文件丢到垃圾箱。如果你想彻底删除(不使用垃圾箱)，在点击删除时，请按着Shift键。

如果你想要仔细检查一个文件，你可以把它拖到其他的应用中，例如文本编辑器或者IDE，或者你可以把它拖到资源管理器中的一个文件夹来保存副本。

这些列是可定制的。如果你右击任何一列的头部，你就会看到一个上下文菜单，允许你选择哪一列要显示。还可以在鼠标移动到列边界时通过拖动把手来改变列的宽度。这些定制的内容都会被保留下来，下一次你会见到相同的头部。

如果你同时做几个不相关的任务，也可以在修改列表中分组文件。阅读“修改列表”一节以获得更多信息。

在对话框的底部可以看到在你的工作副本中所使用的版本库版本号范围的总结。它们是 提交 的版本号，不是 更新 的版本号; 它们表示这些文件上一次提交的版本号范围，不是它们被更新的版本号。注意，这个版本号范围仅仅对应于显示的条目，而不是整个工作副本。如果要查看整个工作副本的信息，必须要选中 未修改的 复选框。

通常你想要深入文件中了解你修改了什么。要达到这个目的，你可以选中这个文件，然后在TortoiseSVN的右键菜单中选择比较。这个操作会启动一个外部的差别检查程序，由它来比较当前文件与上一次检出或更新后的原始的副本(基础版本)。

图 4.18. 版本日志对话框

有几种途径可以调出日志对话框:

如果版本库不可用，你将会看到 要离线? 对话框，在 “离线方式”一节 中有详细描述。

顶部面板有个动作列，包含了此版本的动作概要图标。有四个不同的图标，每个都在自己的列显示。

如果某个版本修改了文件或目录，已修改 图表就会在首列显示。

如果某个版本增加了文件或目录，已增加 图表就会在第二列显示。

如果某个版本删除了文件或目录，已删除 图表就会在第三列显示。

如果某个版本替换了文件或目录，已替换 图标就会在第四列显示。

如果一个修订版本移动了，或者重命名了一个文件或目录，移动图标在第四栏显示。

如果修订版本通过移动/重命名替换了文件或者目录，移动替换图标显示在第四栏。

如果某个版本合并了文件或目录，合并 图标就会在第四列显示。

如果某个版本取消合并了文件或目录，取消合并 图标就会在第四列显示。

图 4.19. 版本日志对话框的顶部面板的右键菜单

日志对话框的顶部面板有一个右键菜单，通过此菜单你可以获得更多信息。这些菜单条目中的有些内容只会在显示文件日志时出现，有些内容只有显示文件夹日志时出现。

图 4.20. 选中两个版本的顶部面板的右键菜单

如果你使用Ctrl组合键一次选中了两个版本，右键菜单有所改变:

如果你用 Ctrl 或 Shift 组合键选择了两个或多个版本，右键菜单将有一个选项，可以让你还原这些选中的版本中的修改。这是一次性还原一组版本中修改的最简方法。

你也可以合并选中的版本到别的工作副本，就像上面描述的那样。

如果所有选中的版本作者是相同的，你可以同时修改这些版本的作者。

图 4.21. 日志对话框的底部面板的右键菜单

日志对话框的底部面板有一个右键菜单，通过此菜单

在多个文件被选中时，日志对话框的底部面板，右键菜单会显示如下更改：

图 4.22. 当多个文件被选中，日志对话框底部面包会有上下文菜单

日志对话框并不总是显示所有曾经的修改，日志不显示的可能原因如下:

如果你要查看更多的日志信息，点击下100个，以获取下100个日志信息。如果有需要你可以多次重复这个操作。

这个按钮旁边的是一个多功能按钮，它可以记住上一次你要它进行的操作。点击它上面的箭头，可以看到更多的选项。

如果你要查询指定范围的版本，使用显示范围 ...。这会出现一个对话框，要求输入开始和结束的版本。

如果你要查询从最新版本直到版本1的所有的日志消息，使用显示所有。

当日志对话框显示后有其他人进行了提交的情况下，可以单击 F5 键来刷新最新的版本。

单击 Ctrl-F5 键来刷新日志缓存。

因为日志对话框从最新版本开始显示日志，而不是从当前工作副本的版本开始。还未被更新至工作副本中的版本的日志消息也经常会显示出来。为了使其更清楚，符合当前工作副本版本的提交信息使用粗体显示。

当你显示文件夹的日志时，高亮的版本是此文件夹中的最高版本，这就需要遍历工作副本。遍历操作在单独的进程中进行，因此不会使显示日志有延迟，但是这样的结果就是高亮也许不会立刻显示出来。

Subversion 1.5 及以后的版本使用属性保留合并记录。关于已合并的修改，我们可以获得更详细的历史。例如，你在分支中开发了一个新特性并且将此分支合并到主干，此特性开发将会以一次合并提交的形式显示在主干的日志中，即使在分支开发中可能有 1000 次提交。

图 4.23. 日志对话框显示合并跟踪版本

如果你想查看此次提交中有哪些版本被合并的详细信息，选中 包含合并版本。这样将会再次获取日志信息，同时也会插入被合并的版本的日志信息。被合并的版本使用灰色显示，因为它们代表在版本库中不同部分的修改。

当然，合并绝非简单！在分支上进行特性开发过程中，也许不时的会将主干的内容合并至分支使分支保持同步。所以分支的合并历史将会包含其它层次的合并历史。这些不同层次的信息在日志对话框中使用不同的缩进级别显示。

版本属性完全不同于其它的 Subversion 属性。版本属性是关联于版本库中的特定版本号的描述项目，例如日志消息，提交日期和提交者名称(作者)。

有时你可能想要修改你曾经输入的日志消息，也许是因为有拼写错误或是你想改进消息内容，或是其他别的原因。偶尔你还想修改提交者，可能是你忘了设置认证等原因。

Subversion lets you change revision properties any time you want. But since such changes can't be undone (those changes are not versioned) this feature is disabled by default. To make this work, you must set up a pre-revprop-change hook. Please refer to the chapter on Hook Scripts in the Subversion Book for details about how to do that. Read “服务器端钩子脚本”一节 to find some further notes on implementing hooks on a Windows machine.

一旦你按需要为服务器设置了钩子，你就可以使用日志对话框顶部面板的右键菜单来修改任意版本的作者和日志信息(或其它版本属性)了。你也可以使用中间面板的右键菜单编辑日志信息。

如果你只想要显示上千条日志中你所感兴趣的日志，你可以使用日志对话框顶部的过滤器控件。开始和结束日期控件允许你查看指定日期范围内的输出。查找框帮你查出含有指定内容的信息。

单击查找图标可以选择在哪些信息中查找，并选择 正则表达式 模式。正常情况下你可能只需要进行简单的子字符串查找，但如果你需要更有弹性的查找条件，就可以使用正则表达式。如果将鼠标在文本框上停留一会，就会出现一个工具提示条显示一些如何使用正则表达式功能和子字符串功能的使用帮助。过滤器检查字符串是否与日志内容匹配，并且只有 匹配 过滤字符串的条目才会显示。

Simple sub-string search works in a manner similar to a search engine. Strings to search for are separated by spaces, and all strings must match. You can use a leading - to specify that a particular sub-string is not found (invert matching for that term), and you can use ! at the start of the expression to invert matching for the entire expression. You can use a leading + to specify that a sub-string should be included, even if previously excluded with a -. Note that the order of inclusion/exclusion is significant here. You can use quote marks to surround a string which must contain spaces, and if you want to search for a literal quotation mark you can use two quotation marks together as a self-escaping sequence. Note that the backslash character is not used as an escape character and has no special significance in simple sub-string searches. Examples will make this easier:

Alice Bob -Eve
      

searches for strings containing both Alice and Bob but not Eve

Alice -Bob +Eve
      

searches for strings containing both Alice but not Bob, or strings which contain Eve.

-Case +SpecialCase
      

searches for strings which do not contain Case, but still include strings which contain SpecialCase.

!Alice Bob
      

searches for strings which do not contain both Alice and Bob

!-Alice -Bob
      

do you remember De Morgan's theorem? NOT(NOT Alice AND NOT Bob) reduces to (Alice OR Bob).

"Alice and Bob"
      

searches for the literal expression “Alice and Bob”

""
      

searches for a double-quote anywhere in the text

"Alice says ""hi"" to Bob"
      

searches for the literal expression “Alice says "hi" to Bob”.

如何使用正则表达式进行查找超出了本手册的范围，你可以查看在线文档和教程 http://www.regular-expressions.info/。

要注意的是，这些过滤器只对已经获取的信息有效。它们并不从版本库中下载信息。

在底部的面板选中 仅显示影响的路径 复选框可以过滤路径名称。影响的路径就是那些用来显示日志的路径。如果是获取文件夹的日志，就是指文件夹中的或者以下的任何内容。对于文件，就是指该文件。正常情况下，路径列表会显示受本次提交影响的其它路径，但是是灰色的。如果选中该复选框，这些路径就会被隐藏。

有时，工作规范要求日志消息符合一个特定的格式，这就意味着描述修改的文本不能在顶部面板中以简短的摘要形式显示。属性 tsvn:logsummary 可以用于提取日志消息的一部分显示在顶部面板中。参阅 “TortoiseSVN 项目属性”一节 了解如何使用这个属性。

统计按扭，可以显示一些你感兴趣的关于日志对话框中版本的信息。可以显示已经有几个作者做了工作，他们各提交了几次，按周的统计，等等。现在，你可以发现一个大概情况: 谁最勤快，谁偷懒。;-)

作者提交次数统计页

图 4.24. 作者提交次数统计柱状图

此图用简单柱状图、叠加柱状图或饼图显示了哪些作者已经在项目中活跃了。

图 4.25. 作者提交次数统计饼图

其中有几个主要作者和许多辅助的贡献者。由于太小的部分会导致图形难于阅读，所以在底部有个滑动条，可以设置一个范围(占所有提交的百分比)，在这个范围下的所有行为都整合成其他类。

按日期提交统计页

图 4.26. 按日期提交统计图

本页图示了以提交次数和作者作为条件的项目行为统计。这里可以看出项目什么时候有人在工作，以及什么人在什么时候进行了工作。

如果有多个作者，你就会在图中看到多行。有两种视图可用正常，在这里，每个作者的行为都相对于基线；叠加，在这里每个作者的行为是相对于他的下面那条线。后一种视图避免了线的交叉，对于图来说更明了，但对查看一个作者的输出比较不直观。

默认统计是区别大小写的，也就是说用户 PeterEgan 与 PeteRegan 被认为是两个不同的作者。但在多数时候用户名并不区别大小写，有时会存在不一致，所以你可能希望 DavidMorgan 和 davidmorgan 能被当成是同一个作者。使用作者区分大小写复选框来控制。

注意，统计只包括了日志对话框中的那段时期。如果日志对话框中只显示一个版本，那么统计就没有什么意义了。

图 4.27. 要离线对话框

如果服务器不可用，并且你已经启用了日志缓存，那么你可以在离线方式下使用日志对话框和版本图。它使用缓存中的数据，使得你可以继续工作，尽管信息可能不是最新的甚至不完整。

这里你有三个选择:

选中设为默认值复选框使用你本次的选项作为以后的选择，避免再次显示此对话框。你可以通过 TortoiseSVN → 设置修改(或删除)此默认值。

如果你想再次检查服务器是否有新的日志消息，可以使用 F5 键来刷新视图。如果使用日志缓存(默认启用)，这将会检查版本库是否有新的消息并且只获取新的消息。如果日志缓存处于离线模式，这将会尝试恢复在线模式。

如果使用日志缓存并且你认为消息内容或者作者可能被更改，你可以使用 Shift-F5 或 Ctrl-F5 来从服务器重新获取显示的消息并更新日志缓存。注意: 此动作只影响当前显示的消息并不会影响此版本库的全部缓存。

如果你已经配置了第三方的比较工具，你可以在选择比较差异命令的时候按下 Shift 键来选择替代工具。关于配置其它比较工具，请参阅 “外部程序设置”一节。

在项目的生命周期中，有时可能会将行结束符由 CRLF 改为 LF，或者修改一段代码的缩进。不幸的是这样将会使大量的代码行被标记为已修改，尽管代码本身并没有被修改。这里列出的选项将会在比较差异和应用补丁时帮助你应对这些修改。你将会在合并和追溯对话框中看到这些设置，它们同样也出现在 TortoiseMerge 的设置中。

忽略行结束符 排除仅行结束符的差异。

比较空白 将所有缩进和行内空白差异视为增加/删除的行。

忽略空白修改 排除那些完全是针对空白数量或类型的修改，例如，修改缩进或者将 tab 改为空格。在原来没有空白的地方增加空白或删除全部空白仍然会显示为修改。

忽略所有空白 排除仅空白改变的差异。

自然的，任何已经修改内容的行永远都包含在差异中。

图 4.28. 比较修订版本对话框

当你在版本库浏览器中选择了两个树，或者在日志对话框中选择了一个文件夹的两个版本，就可以使用右键菜单 → 比较版本差异。

这个对话框显示一个所有已经修改的文件列表，允许你使用右键菜单单独的比较或追溯它们。

你可以导出修改树，当你需要将仅包含已修改文件的项目树结构发送给其它人的时候很有用。这个操作仅对选中的文件有效，所以需要选择你感兴趣的文件 - 通常这就意味着全部文件 - 然后使用右键菜单 → 导出选择项...。然后会提示你选择目录保存修改树。

你也可以通过右键菜单 → 保存选择文件列表将修改过的文件列表导出为文本文件。

如果你需要导出文件列表和动作(修改，增加，删除)，你可以使用右键菜单 → 复制到剪贴板。

顶部的按钮允许你改变比较的方向。你可以显示从A到B的修改，或者如果你喜欢，显示从B到A的修改。

有版本数字的按钮可以用来改变版本范围。当你改变范围时，两个版本不同的项目列表会自动更新。

如果列表中的文件非常多，你可以使用查找框来筛选文件名中包含指定文字的文件，从而减少列表中的文件。注意这里使用的是简单文本查找，所以当你需要显示 C 语言源码的列表时，你应该输入.c 而不是 *.c。

我们有许多有用的比较文本文件的工具，包括我们自带的TortoiseMerge，但是我们也需要查看图像文件的更改。这就是我们设计TortoiseIDiff的原因。

图 4.29. 差异察看器截图

TortoiseSVN → 比较差异 会启动 TortoiseIDiff 显示常用格式的图像差异。一般情况下是左右对称地显示两个图像，但你也可以通过视图菜单或者工具栏切换为上下显示的模式，或者如果你愿意，也可以重叠显示图像。

当然你也可以放大和缩小，或者移动图像。你也可以简单的通过左键拖拽来移动图像。如果你选择链接图像位置，则移动控制(滑动条，鼠标滚轮)对两幅图像同时生效。

在图像信息框中显示了图像的基本信息，比如像素的大小，颜色的深度。如果觉得这个框碍眼可以选择视图 → 图像信息来隐藏它。当你的鼠标指针位于图像标题栏上方时，可以从工具提示中获得同样的信息。

当图像叠加时，图像的相对亮度(alpha 混合)由左边的滑杆控制。你可以点击滑杆的任意地方来设置混合参数，或者通过拖曳滑杆来交互改变。Ctrl+Shift-鼠标滚轮也可以改变混合参数。

滑杆上方的按钮可以切换 0% 和 100% 混合，如果你双击按钮，会每隔两秒钟自动切换，直到再次点击按钮为止。当查看多处小更改时，这个功能很有用。

有时你想要查看不同但不是混合图像。也许你有两个版本的印刷电路板图像文件，想查看哪些线条改变了。如果你关闭 alpha 混合模式，不同之处会以像素颜色值的或非(XOR)结果显示。未修改的区域是纯白色的，修改的部分则是彩色的。

When you want to diff non-text documents you normally have to use the software used to create the document as it understands the file format. For the commonly used Microsoft Office and Open Office suites there is indeed some support for viewing differences and TortoiseSVN includes scripts to invoke these with the right settings when you diff files with the well-known file extensions. You can check which file extensions are supported and add your own by going to TortoiseSVN → Settings and clicking Advanced in the External Programs section.

如果我们提供的这些工具不是你所需要的，可以尝试使用一些其他开源的或者商业的软件。每个人都有不同喜好，下面列表虽不完全，或许有些你也会认可的:

“外部程序设置”一节这里可以了解到怎样起用TortoiseSVN来使用这些工具。

Subversion 的忽略模式使用了文件匹配，一种原先在Unix系统中使用meta字符作为通配符的技术。下面的字符有着特殊的意思:

模式匹配是大小写敏感的，这在 Windows 平台下会出问题。你可以使用成对的字符来强制忽略大小写。例如，忽略不记 *.tmp 的大小写，那么你可以使用像 *.[Tt][Mm][Pp] 这样的模式。

如果你想要一个官方定义的匹配规则。你可以在关于shell命令行语言的IEEE规范Pattern Matching Notation中找到。

使用 TortoiseSVN → 删除 从 Subversion 中删除文件或文件夹。

When you TortoiseSVN → Delete a file or folder, it is removed from your working copy immediately as well as being marked for deletion in the repository on next commit. The item's parent folder shows a “modified” icon overlay. Up until you commit the change, you can get the file back using TortoiseSVN → Revert on the parent folder.

如果你想从版本库删除项目，但是在本地作为非版本控制的文件/文件夹保留，可以使用 扩展右键菜单 → 删除(保留本地副本)。为了看到扩展右键菜单，当你在文件管理器列表窗格(右窗格)中的项目上点击右键时，必须同时按下 Shift 键。

If an item is deleted via the explorer instead of using the TortoiseSVN context menu, the commit dialog shows those items as missing and lets you remove them from version control too before the commit. However, if you update your working copy, Subversion will spot the missing item and replace it with the latest version from the repository. If you need to delete a version-controlled file, always use TortoiseSVN → Delete so that Subversion doesn't have to guess what you really want to do.

如果你仅想重命名文件或文件夹，使用 右键菜单 → 改名... 为此条目输入新的名称就可以了。

如果你想在工作副本中移动文件，比如移动到一个不同的子文件夹下，那么使用鼠标右键拖拽:

另外一种复制或移动文件的方法是通过Windows 的复制/移动命令. 首先选择你需要复制的文件, 在资源管理器中右键点击并选择右键菜单 → 复制. 然后进入目标文件夹，右键点击并选择TortoiseSVN → 粘贴. 对于移动文件，选择 右键菜单 → 剪切而不是右键菜单 → 复制.

你也可以使用版本库浏览器在版本库中移动条目。阅读 “版本库浏览器”一节 以获得更多信息。

万一在你的版本库中有两个名字相同但大小拼写不同(例如: TEST.TXT 和 test.txt)的文件，你是不能在 Windows 客户端更新或者检出该包含该文件的目录的。当 Subversion 支持大小写敏感的文件名时，Windows 不支持。

它偶尔在两个人在独立的工作副本提交时发生，文件名称相同，只有大小写不同。它也会在具有大小写敏感的文件系统的系统中提交文件时发生，例如 Linux。

如果是那样的话，你得决定在这个版本库里的哪一个文件是你想保留的，哪一个是要删除(或重命名)的

有时候你的IDE会因为执行反射操作，改名文件，当然它不能告诉Subversion。如果你尝试提交修改，Subversion会发现丢失了老文件，新增了未版本控制的新文件。你可以简单的增加新文件，但是你将丢失历史记录，因为Subversion不知道这些文件的关系。

更好的方法是通知Subversion这实际上是改名，你可以在提交和检查修改对话框中做此操作。简单选择老文件(丢失的)和新文件(未版本控制的)，使用右键菜单 → 修复移动设置这两个文件是改名关系。

通常你可以在Subversion中设置自己的忽略列表，例如忽略所有产生的文件。但是你如何清理这些忽略的项目，从而产生一个干净的构建呢？通常你在makefile中清理，但是如果你在调试makefile，或者修改构建系统，那么有一个清理方法是极为有用的。

TortoiseSVN 提供了使用扩展上下文菜单 → 删除未版本控制的项目...来清理工作副本。你可以在目录上右键操作时，保持 Shift按下，就可以看到这个上下文菜单。它会出现一个对话框，列出工作副本中的所有未版本控制的文件。你可以选择或取消删除的项目。

当删除这些项目时，使用了垃圾箱。所以如果你犯了错误，删除了应该版本控制的文件，你仍旧可以恢复。

图 4.35. Subversion 属性页

你可以通过右键菜单 → 属性从 Windows 属性对话框来读写 Subversion 属性，这样也能得到 TortoiseSVN 的状态列表。也可以从TortoiseSVN → 属性来读写 Subversion 属性。

你可以添加你自己定义的属性，或者一些在 Subversion 中有特殊含义的属性。这些属性以 svn: 开头。svn:externals 就是这一类型的属性; 关于如何引用外部条目，请参阅“外部条目”一节.

更多的关于 Subversion 中属性的信息可以看Special Properties。

增加和编辑属性

图 4.36. 增加属性

要添加一个新的属性，先点击新建... 。从菜单中选择需要的属性名称，然后在特定的属性对话框内填写所需的信息。这些特定的属性对话框中详细描述“属性编辑器”一节 。

想添加没有自己的对话框的属性，从新建... 菜单中选择高级 。然后从组合框中选择已经存在的属性或者输入自定义的属性名称。

如果你想一次性设置许多文件的属性，在资源管理器中选择文件/文件夹，然后选择右键菜单 → 属性。

如果你想设置当前文件夹内的全部文件和文件夹，选中递归检查框。

如果你想编辑一个已有属性，在已有属性列表中选择它，然后单击编辑...即可。

如果你想删除已有属性，在已有属性列表中选择它，然后单击删除即可。

属性svn:externals可以用来下载位于同一版本库或不同版本库的其它工程。阅读“外部条目”一节以获得更多信息。

编辑最新修订版本的属性

因为属性是受版本控制的，因此您不能编辑以前修订版本的属性。如果您从日志对话框或库浏览器中的无头部修订版本来查看属性，您将会看到一个属性和值的列表，但没有编辑控件。

TortoiseSVN 有自己专用的几个属性，它们都有tsvn:前缀。

TortoiseSVN 可以与一些 BUG 跟踪工具集成。它使用 bugtraq: 开始的项目属性。阅读“与 BUG 跟踪系统/问题跟踪集成”一节以获得更多信息。

它也与一些基于 WEB 的版本库浏览器集成，使用 webviewer: 开始的项目属性。阅读“与基于 WEB 的版本库浏览器集成”一节以获得更多信息。

当你使用TortoiseSVN在工作副本中新建一个子目录， 上层目录的所有项目属性都会自动的被继承。.

有些属性必须使用特定的值或以某种特定的方式进行格式化，以便能被自动使用。为了帮助正确地进行格式化，TortoiseSVN 为某些显示可能值或将属性分解给它的单独组件的特殊属性提供了编辑对话框。

外部条目

图 4.42. svn:externals 属性页

svn:外部 属性可用于从同一版本库或一个如 “外部条目”一节 所述的完全不同的版本库中引入其他项目。

You need to define the name of the sub-folder that the external folder is checked out as, and the Subversion URL of the external item. You can check out an external at its HEAD revision, so when the external item changes in the repository, your working copy will receive those changes on update. However, if you want the external to reference a particular stable point then you can specify the specific revision to use. IN this case you may also want to specify the same revision as a peg revision. If the external item is renamed at some point in the future then Subversion will not be able to update this item in your working copy. By specifying a peg revision you tell Subversion to look for an item that had that name at the peg revision rather than at HEAD.

The button Find HEAD-Revision fetches the HEAD revision of every external URL and shows that HEAD revision in the rightmost column. After the HEAD revision is known, a simple right click on an external gives you the command to peg the selected externals to their explicit HEAD revision. In case the HEAD revision is not known yet, the right click command will fetch the HEAD revision first.

SVN 关键字

图 4.43. svn:keywords 属性页

选择你想要在文件中被扩展的关键字。

EOL 样式

图 4.44. svn:eol-style 属性页

选择您想使用的并且 TortoiseSVN 会使用正确属性值的行结束样式。

问题跟踪器集成

图 4.45. tsvn:bugtraq 属性页

日志消息大小

图 4.46. 日志信息属性页的大小

These 3 properties control the formatting of log messages. The first 2 disable the OK in the commit or lock dialogs until the message meets the minimum length. The border position shows a marker at the given column width as a guide for projects which have width limits on their log messages. Setting a value to zero will delete the property.

项目语言

图 4.47. 语言属性页

Choose the language to use for spell-checking log messages in the commit dialog. The file lists checkbox comes into effect when you right click in the log message pane and select Paste file list. By default the Subversion status will be shown in your local language. When this box is checked the status is always given in English, for projects which require English-only log messages.

MIME 类型

图 4.48. svn:mime-type 属性页

svn:needs-lock

图 4.49. svn:needs-lock 属性页

此属性只是简单地控制一个文件是否要被检出为只读，如果没有在工作副本中锁定它。

svn:executable

图 4.50. svn:executable 属性页

该属性控制一个文件在 Unix/Linux 系统上检出时是否将被给予可执行状态。在 Windows 签出时则没有任何影响。

合并日志信息模板

Whenever revisions are merged into a working copy, TortoiseSVN generates a log message from all the merged revisions. Those are then available from the Recent Messages button in the commit dialog.

你可使用以下属性自定义生成的信息：

图 4.51. 合并日志信息模板属性对话框

tsvn:mergelogtemplatetitle, tsvn:mergelogtemplatereversetitle

This property specifies the first part of the generated log message. The following keywords can be used:

{revisions}

A comma separated list of the merged revisions, e.g., 3, 5, 6, 7

{revisionsr}

Like {revisions}, but with each revision preceded with an r, e.g., r3, r5, r6, r7

{revrange}

A comma separated list of the merged revisions, grouped into ranges if possible, e.g., 3, 5-7

{mergeurl}

The source URL of the merge, i.e., where the revisions are merged from.

The default value for this string is Merged revision(s) {revrange} from {mergeurl}: with a newline at the end.

tsvn:mergelogtemplatemsg

This property specifies how the text for each merged revision should look like. The following keywords can be used:

{msg}

The log message of the merged revision, as it was entered.

{msgoneline}

Like {msg}, but all newlines are replaced with a space, so that the whole log message appears on one single line.

{author}

合并修订版本号的作者

{rev}

The merged revision itself.

{bugids}

The bug IDs of the merged revision, if there are any.

tsvn:mergelogtemplatemsgtitlebottom

This property specifies the position of the title string specified with the tsvn:mergelogtemplatetitle or tsvn:mergelogtemplatereversetitle. If the property is set to yes or true, then the title string is appended at the bottom instead of the top.

重要

This only works if the merged revisions are already in the log cache. If you have disabled the log cache or not shown the log first before the merge, the generated message won't contain any information about the merged revisions.

比方说您检出了一个 /project1 工作副本到 D:\dev\project1。选择文件夹 D:\dev\project1，右击 该文件夹并从上下文菜单中选择 Windows 菜单 → 属性。属性对话框出现。然后转到 Subversion 选项卡。在那里您可以设置属性。单击 属性...。在属性对话框中，即可以双击 svn:externals 如果它已经存在，或点击 新建... 按钮并从菜单中选择 externals。要添加新的外部项目，单击 新建...，然后在显示的对话框中填写所需的信息。

如果你需要在本地路径中包含空格或其它特殊字符，你可以使用双引号将它们括起来，或者你可以使用 Unix shell 风格的转义字符 -- 在特殊字符前添加 \ (反斜线)。当然这样就意味着你必须使用 / (正斜线)作为路径的分隔符。注意：这一特性是在 Subversion 1.6 中新引入的，不支持旧版本的客户端程序。

如果外部项目位于同一版本库，当你提交你的主要项目时，你在这儿所做的任何更改都将包含在提交列表中。

If the external project is in a different repository, any changes you make to the external project will be shown or indicated when you commit the main project, but you have to commit those external changes separately.

如果你在 svn:externals 定义中使用绝对 URL 并且你不得不重定位你的工作副本(例如，版本库的 URL 改变了)，然后你的外部定义并不会改变，它可能就失效了。

要避免这样的问题，Subversion 客户端程序 1.5 版及更高版本支持相对外部 URL。四种不同的指定相对 URL 的方式被支持。在下面的例子中，假设我们有两个版本库: 一个位于 http://example.com/svn/repos-1，另一个位于 http://example.com/svn/repos-2。我们签出 http://example.com/svn/repos-1/project/trunk 到C:\Working 并且在 trunk 设置 svn:externals 属性。

You can also specify a peg and operative revision for the URL if required. To learn more about peg and operative revisions, please read the corresponding chapter in the Subversion book.

如果你需要TortoiseSVN如何处理属性的更多信息，请阅读“项目设置”一节。

如果你需要知道存取公共子个我我你工程的不同方法，请阅读“包含一个普通的子项目”一节.

从 Subversion 1.6 版起，你可以将单独的文件作为外部引用添加到你的工作副本中，它使用和外部文件夹相同的语法格式。然而，这里有一些限制。

外部文件行为在许多方面与其它版本控制的文件类似，但是它们不能使用普通的命令进行移动或删除；必须通过修改 svn:externals 来替代上述操作。

If you already have a working copy of the files or folders you want to include as externals in another working copy, you can simply add those via drag and drop from the windows explorer.

Simply right drag the file or folder from one working copy to where you want those to be included as externals. A context menu appears when you release the mouse button: SVN Add as externals here if you click on that context menu entry, the svn:externals property is automatically added. All you have to do after that is commit the property changes and update to get those externals properly included in your working copy.

如果你用推荐的目录结构导入了一个工程，那么创建分支或标记就非常简单:

图 4.52. 分支/标记对话框

在你当前的工作副本中选择你想要复制的分支或标记的目录，然后选择命令TortoiseSVN → 分支/标记...。

The default destination URL for the new branch will be the source URL on which your working copy is based. You will need to edit that URL to the new path for your branch/tag. So instead of

http://svn.collab.net/repos/ProjectName/trunk
      

you might now use something like

http://svn.collab.net/repos/ProjectName/tags/Release_1.10
      

If you can't remember the naming convention you used last time, click the button on the right to open the repository browser so you can view the existing repository structure.

现在你需要选择从哪里复制。这里你有三个选择:

如果想要将工作副本自动切换到新创建分支，选中切换工作副本至新分支/标记复选框。但是如果你要这样做，首先确认你的工作副本中不包含修改。如果有，这些修改将会在你切换时合并到分支的工作副本中。

If your working copy has other projects included with svn:externals properties, those externals will be listed at the bottom of the branch/tag dialog. For each external, the target path and the source URL is shown.

If you want to make sure that the new tag always is in a consistent state, check all the externals to have their revisions pinned. If you don't check the externals and those externals point to a HEAD revision which might change in the future, checking out the new tag will check out that HEAD revision of the external and your tag might not compile anymore. So it's always a good idea to set the externals to an explicit revision when creating a tag.

The externals are automatically pinned to either the current HEAD revision or the working copy BASE revision, depending on the source of the branch/tag:

按下确认提交新副本到版本库中。别忘了提供一条日志信息。需要注意的是这个副本是在版本库内部创建的。

需要注意除非你决定切换工作副本到新创建分支，建立一个分支或标记不会影响你的工作副本。即使你从工作副本创建分支，这些修改也会提交到新分支里，而不是到主干里，所以你的工作副本可能仍然标记为已修改状态来避免影响主干。

你可以在没有工作副本的情况下创建分支或标记。要这样做，打开版本库浏览器。你可以拖拽文件夹到新的位置。要创建副本，你必须在拖拽过程中按下 Ctrl 键，否则文件夹是被移动，不是被复制。

你可以使用鼠标右键拖拽文件夹。一旦你松开鼠标右键，你可以从右键菜单中选择移动或复制文件夹。当然，要创建分支或标记你必须复制文件夹，而不是移动它。

还有一个方法就是从日志对话框。你可以显示某个文件夹，例如 trunk，的日志对话框，选择一个版本(可以是位于顶端的最新版本，也可以是先前的版本)，右键单击并选择从版本创建分支/标记。

...这是个小问题。当从版本库中预期的分支检出所有数据到你的工作副本目录时，TortoiseSVN → 切换... 仅仅传输已经被修改的数据到你的工作副本中。有利于减轻网络负担，也有利于你的耐心。 :-)

为了能够使用你最新产生的副本或标记，你可以采用下面几种方法。你可以:

图 4.53. 切换对话框

尽管 Subversion 本身不区分标记和分支，但它们通常被应用的场合还是有些不同。

图 4.54. 合并向导 - 选择版本范围

在从:文本框中输入分支或标记文件夹的完整 URL，它包含了你想应用到工作副本的修改。你也可以点击...浏览版本库，找到想要的分支。如果你以前已经从这个分支合并过，可以直接从包含历史的下拉列表选择以前使用的 URL。

If you are merging from a renamed or deleted branch then you will have to go back to a revision where that branch still existed. In this case you will also need to specify that revision as a peg revision in the range of revisions being merged (see below), otherwise the merge will fail when it can't find that path at HEAD.

在待合并的版本范围文本框中输入你想合并的版本列表。它可以是单一版本，用逗号隔开的指定版本列表，或用横线(-)连接的版本范围，或这些形式的组合。

If you need to specify a peg revision for the merge, add the peg revision at the end of the revisions, e.g. 5-7,10@3. In the above example, the revisions 5,6,7 and 10 would be merged, with 3 being the peg revision.

选择版本范围最简单的方法是，点击显示日志，列出最近的修改和日志。如果你要合并单个版本的修改，直接选取那个版本。如果你要合并多个版本，就选择范围(使用通常的Shift键)。点击确认，就会为你填写要合并的版本号列表。

如果您要将更改往回合并 出 您的工作副本，以还原一个已提交的更改，选择要还原的版本并确保选中了 反向合并 框。

如果你已经从这个分支合并了一些修改，希望你在提交日志中注明最后一个合并的版本号。这时，你可以在工作副本上使用显示日志对话框跟踪日志。记住，我们将版本号视作修改集，你应该使用最后合并的版本之后的版本作为本次合并的开始版本。例如，上次你已经合并了版本37到39，那么本次合并你应该从版本40开始。

如果你在使用 Subversion 的合并跟踪特性，你就不需要记住已经合并了那些版本 - Subversion 将会帮你记录。如果不填写版本范围，所有未合并的版本将被选中。阅读“合并跟踪”一节获得更多信息。

When merge tracking is used, the log dialog will show previously merged revisions, and revisions pre-dating the common ancestor point, i.e. before the branch was copied, as greyed out. The Hide non-mergeable revisions checkbox allows you to filter out these revisions completely so you see only the revisions which can be merged.

如果其他用户可能提交，那么要小心使用最新版本。如果有人在你最近更新之后提交了，它指代的版本可能就不是你想的那样了。

If you leave the range of revisions empty or have the radio button all revisions checked, then Subversion merges all not-yet merged revisions. This is known as a reintegrate or automatic merge.

复兴合并需要满足一些条件。首先，服务器必须支持合并跟踪。工作副本必须为完全递归 (不是有限的检出深度)，而且它不能具有任何本地修改、交换项目或已更新为最新版本之外的其他版本的项目。分支开发过程中的所有主干更改必须已合并到分支 (或标记为已合并)。要合并的版本范围将自动被计算。

点击下一页跳转到“合并选项”一节 。

图 4.55. 合并向导 - 树合并

如果您正使用此方法将一个特性分支合并回主干，你需要从一个主干工作副本内启动合并向导。

在 起始： 区域输入 主干 的完整文件夹地址。这听起来像是错了，但请记住主干是要添加分支更改的起始点。你也可以点击 ... 浏览版本库。

在到:域输入关注的分支中文件夹的全路径。

在开始版本和结束版本 域，输入两个树被同步的最后一个版本号。如果你确信没有其他人提交，两个都可是输入 HEAD。如果在同步时可能有人提交的话，使用清楚的版本号以便面丢失最新提交。

也可以使用 显示日志 选择版本。

此向导页可以指定合并进程开始前的高级选项。一般情况下你可以直接使用默认设置。

您可以指定合并深度，也就是到工作副本的合并程度。深度条款在 “检出深度”一节 中有所描述。默认深度是 工作副本，使用现有的深度设置，并且几乎能满足所需。

Most of the time you want merge to take account of the file's history, so that changes relative to a common ancestor are merged. Sometimes you may need to merge files which are perhaps related, but not in your repository. For example you may have imported versions 1 and 2 of a third party library into two separate directories. Although they are logically related, Subversion has no knowledge of this because it only sees the tarballs you imported. If you attempt to merge the difference between these two trees you would see a complete removal followed by a complete add. To make Subversion use only path-based differences rather than history-based differences, check the Ignore ancestry box. Read more about this topic in the Subversion book, Noticing or Ignoring Ancestry.

您可以指定处理行结束和空白变化的方式。这些选项在 “行结束符和空白选项”一节 中被描述。默认情况是把所有的空白和行结束差异当做将被合并的真实更改。

标记为 强制合并 的复选框用于避免树冲突，传入的删除操作会影响到本地修改或不受版本控制的文件。如果删除了该文件，则无法恢复，这就是为什么在默认情况下未选中该选项。

如果您正在使用合并跟踪并且要将一个版本标记为已合并，而实际上并没有执行合并，那么就选中 只记录合并 复选框。您这样做可能有两个原因。合并过于复杂，合并算法表示压力很大，因此您选择手动更改代码，然后将更改标记为已合并，以便于合并跟踪算法也能识别到。或者您可能想要防止某个特定版本被合并，将其标记为已合并就可以用合并跟踪识别客户端来阻止合并的发生。

现在一切就绪，你要做的就是点击 合并 按钮。如果想要预览结果，测试合并 可以模拟合并操作，但完全 不会 修改工作副本。它会显示一份会被真正合并的文件列表，并通告那些 可能 发生冲突的文件。因为合并跟踪会使合并过程变得更为复杂，没有任何方法可以事先保证完成合并时是否会出现冲突，所以在测试合并中标记为冲突的文件可能在实际的合并中并不会出现任何问题。

The merge progress dialog shows each stage of the merge, with the revision ranges involved. This may indicate one more revision than you were expecting. For example if you asked to merge revision 123 the progress dialog will report “ Merging revisions 122 through 123 ”. To understand this you need to remember that Merge is closely related to Diff. The merge process works by generating a list of differences between two points in the repository, and applying those differences to your working copy. The progress dialog is simply showing the start and end points for the diff.

现在已完成合并。查看合并是否按预期完成是个不错的主意。合并通常是相当复杂的。如果分支跟主干偏差太大，往往会出现冲突。

对于 Subversion 客户端和服务器 1.5 之前的版本，不会存储合并信息并且合并的版本必须手动进行跟踪。当您测试完更改来提交这次修订版本时，您的提交日志信息应该会 始终 包括在合并中已导入的版本号。如果以后要应用另一个合并，您需要知道你已经合并过的，因为没人愿意多次地导入更改。这有关的详细信息，请参阅 Subversion 书册中的 最佳的合并实践。

如果你的服务器和所有客户端都使用 Subversion 1.5 或更高版本，合并跟踪工具会记录已经合并的版本，避免某个版本被合并多次。它会使你的生活更简单，因为你每次都可以简单的合并全部版本范围，并且知道只有新版本才会实际被合并。

分支管理很重要。如果你要保持这个分支与最新版本同步，你应当经常合并，这样分支和最新版本的差别就不会太大。当然，你仍旧应该遵循上面的说明，避免重复合并修改。

Subversion 1.5 引入了合并跟踪特性。当你合并版本树时，版本号会被保存，此信息可以用于几个目的。

执行合并时客户端将合并跟踪信息存储在 svn:mergeinfo 属性中。提交合并时，服务器会将该信息存储在数据库中，而当您请求合并、日志或追溯信息时，服务器可以作出恰当的响应。为了使系统正常工作，您必须确保服务器、版本库和所有客户端都是最新的。较早的客户端将不会存储 svn:mergeinfo 属性并且早期版本的服务器端不会提供新版客户端所请求的信息。

Find out more about merge tracking from Subversion's Merge tracking documentation.

Merging does not always go smoothly. Sometimes there is a conflict. TortoiseSVN helps you through this process by showing the merge conflict dialog.

图 4.56. The Merge Conflict Dialog

It is likely that some of the changes will have merged smoothly, while other local changes conflict with changes already committed to the repository. All changes which can be merged are merged. The Merge Conflict dialog gives you different ways of handling the lines which are in conflict.

For normal conflicts that happen due to changes in the file content or its properties, the dialog shows buttons which allow you to chose which of the conflicting parts to keep or reject.

If there's a tree conflict, please first see “树冲突”一节 about the various types of tree conflicts and how and why they can happen.

To resolve tree conflicts after a merge, a dialog is shown with various options on how to resolve the conflict:

图 4.57. The Merge Tree Conflict Dialog

Since there are various possible tree conflict situations, the dialog will show buttons to resolve those depending on the specific conflict. The button texts and labels explain what the option to resolve the conflict does. If you're not sure, either cancel the dialog or use the Postpone button to resolve the conflict later.

当您在一个特性分支上开发一项新特性并完成时，为其重新整合至主干制定一个策略是一个好主意。如果同一时间 主干 上有其他工作也在继续，您可能会发现随着时间推移，差异会变得更显著，复兴合并将成为一场噩梦。

如果新特性较为简单并且开发时间较短，那么您可以采取一种简单的方法，就是将分支完全独立，直到完成该特性，然后将分支更改合并回主干。在合并向导中，选择简单的 合并一个版本范围，该版本范围即是分支的版本跨度。

如果该特性需要花费更长的时间，就要考虑到 主干 中的变化，那么你就需要保持分支同步。这仅仅意味着定期地将主干的修改合并到分支，使分支包含所有主干的修改并 加上 新特性。同步过程使用 合并一个版本范围 。当完成新特性时，那么你可以使用 复兴分支 或 合并两个不同的树 将其合并回 主干。

Another (fast) way to merge all changes from trunk to the feature branch is to use the TortoiseSVN → Merge all... from the extended context menu (hold down the Shift key while you right click on the file).

图 4.58. The Merge-All Dialog

This dialog is very easy. All you have to do is set the options for the merge, as described in “合并选项”一节. The rest is done by TortoiseSVN automatically using merge tracking.

默认情况下，所有的东西都没有锁定，只要有提交权限的人都可以在任何时候提交任何的文件。其他人会定时更新他们的工作副本，在库中的改变的东西都会与本地合并。

如果你对一个文件 取得锁定，那么只有你可以提交这个文件。其他用户的提交都会被拒绝，直到你释放了这个锁。一个被锁定的文件不能在库中进行任何形式的合并。所以它不能除锁的拥用者之外的人删除或更名。

但是，其他用户不必知道你已经增加了锁定，除非他们定期地检查锁定的状态。这其实没什么意义，因为他们发现提交失败的时候就可以知道锁定了。为了更容易管理锁，而设置了一个新的Subversion属性 svn:needs-lock。当一个文件的这个属性被设置(成任意值)的时候，每当该文件检出或更新时，本地的副本都被设成只读，除非该工作副本就是拥有锁的那个用户的。这么做是为了能警告你，你不应该修改这个文件，除非你申请到了锁定。受控只读的文件在TortoiseSVN中用一个特殊的图标来表示你需要在编辑前取得锁定。

锁除了按所有者记录外，还在工作副本中记录。如果你有多个工作副本(在家，在单位)，那么在这些工作副本中，只允许对其中一份拥有锁。

如果你的合作者之一请求一个锁，但却外出旅游去了，你怎么办？Subversion提供了一种强制锁。释放别人拥有的锁被称为破坏锁定，强制获得别人拥有的锁称为窃取锁定。当然，如果你想要与你的合作者保持良好的关系，轻易不要这么做。

锁在库中进行记录，一个锁定令牌建立在你的本地工作副本中。如果有矛盾，比如某人破坏了锁下，那么本地的锁定令牌将不可用。库中的记录将是最权威的参考。

选择工作副本中你想要获取锁定的文件，然后选择命令TortoiseSVN → 取得锁定....

图 4.59. 锁定对话框

出现一个对话框，允许你输入注释，这样别人可以知道你为什么锁定这个文件。注释是可选的，并且只用于基于Svnserve的库。当(且仅当)你需要窃取别人的锁的时候，勾选偷取此锁定复选框，然后点击确定。

您可以设置项目属性 tsvn:logtemplatelock 给要填写如锁定信息的用户提供一个信息模板。请参阅 “项目设置”一节 有关如何设置属性的说明。

如果你选择一个文件夹，使用TortoiseSVN → 获取锁定...锁定对话框将显示所有子文件夹中的所有文件 。如果你真的要锁定整个目录，就这么做，但如果你这么做，可能会很不受你的合作者的欢迎。小心使用...

为了确保你不会忘记释放锁，你不需要做别的事，在提交对话框中，总是会显示锁定的文件，并总是默认被选中。如果你继续提交，选中的文件中的锁就被移除了，就算你从没有修改过。如果你不希望释放某文件的锁，你可以取消选中它(如果你没有修改过)。如果你希望保持一个修改过的文件的锁，你需要在提交之前选中保持锁定复选框。

要手动释放锁定，选中工作副本中要释放的文件，选择命令TortoiseSVN → 释放锁定。不需要输入什么 TortoiseSVN会联系版本库并释放锁。你可以对一个文件夹来使用这个命令释放其中的所有锁定项。

图 4.60. 检查修改对话框

要查看你和他人所拥有的锁，你可以使用TortoiseSVN → 检查修改...命令。本地的锁定令牌会立即显示出来，要查看别人拥用的锁定(或是检查你的锁是否被破坏或窃取)你需要点击检查版本库。

从此处的右键菜单中，你可以获取锁或是释放锁，也可以破坏或是窃取别人的锁。

正如上面提到的，最有效的使用锁的方式是对一个文件设置svn:needs-lock属性。参考“项目设置”一节如何设置属性。带有此属性的文件将总被按只读的方式检出和更新(除非你的工作副本拥有锁定)。

作为提醒的方式之一，TortoiseSVN使用一个特殊的图标表示。

如果你想实行一个每个文件必须被锁定的策略，那么您可能会发现使用 Subversion 的 auto-props 功能来为你每次新添加的文件自动设置属性是更容易的。自动设置属性每次添加新的文件。阅读 “自动属性设置”一节 以进一步了解信息。

当你使用Suversion1.2或更新的版本建立新的版本库的时候，建立了四个钩子模板在版本库中的hooks目录下。这些钩子模板在取得/释放一个锁定之前和之后会被分别调用。

安装一个 post-lock和post-unlock钩子，在钩子中为锁定和解锁事件发送邮件，是个好主意 。有了这种脚本，你的所有用户都会在一个文件被锁定/解锁的时候被通知。在你的版本库文件夹下，你可以找到一个示例钩子脚本hooks/post-lock.tmpl。

你可能也使用hooks来拒绝破坏或是窃取锁定，或是限制只有管理员可以，或是当一个用户破坏或窃取锁定时通知原来的锁定拥有者。

更多内容请参考 “服务器端钩子脚本”一节

首先你需要做出修改并测试这个修改的内容。然后在父目录上使用TortoiseSVN → 创建补丁...代替TortoiseSVN → 提交...。

图 4.61. 创建补丁的对话框

现在你可以选择要包含在补丁中的文件了，就像你要做一个完整的提交一样。这样会产生一个单一的文件，该文件包括一份自从最后一次从仓库更新后你对所选择文件做的全部修改的摘要。

在这一对话框中，纵列和在 检查修改对话框中的纵列同样是可以定制的。更多细节请阅读“本地与远程状态”一节

By clicking on the Options button you can specify how the patch is created. For example you can specify that changes in line endings or whitespaces are not included in the final patch file.

你可以创建包含对不同文件集合修改的相互独立的补丁。当然如果你创建了一个补丁文件，对于同一份文件的更多修改会创建另外一个补丁文件，第二份补丁文件包含了全部的修改。

你可以用一个自己选择的文件名来保存这个补丁文件，补丁文件可以有任意的扩展名，但是按人一般习惯，人们都是用.patch或者.diff作扩展名，你现在已经做好提交你的补丁文件的准备了。

你也可以将补丁保存到剪贴板，而不是文件。这样你可以粘贴到电子邮件中，让他人审核。或者你在机器上有两个工作副本，想将修改传递到另外的副本。在剪贴板上的补丁就是为这些操作提供便利。

If you prefer, you can create a patch file from within the Commit or Check for Modifications dialogs. Just select the files and use the context menu item to create a patch from those files. If you want to see the Options dialog you have to hold shift when you right click.

补丁文件应用到你的工作副本。这应该从用来创建补丁的相同层级文件夹中完成。如果你不确定是什么文件夹，只需查看补丁文件中的第一行。例如，如果被执行的第一个文件是 doc/source/english/chapter1.xml 并且补丁文件的第一行是 Index: english/chapter1.xml 那么您需要应用此补丁至 doc/source/ 文件夹。然而，假如你在正确的工作副本中却选择了错误的层级文件夹，TortoiseSVN 会通知你并提示正确的文件夹。

为了给你的工作副本打补丁，你至少需要对代码库的读权限。因为合并程序必须要参考修订版本中其他开发人员做的修改。

从那个目录的右键菜单，点击TortoiseSVN → 应用补丁... 系统会弹出一个打开文件的对话框，让你选择要应用的补丁文件。默认情况下只显示.patch或者.diff文件，但是你可以选择"所有文件"。如果你以前将补丁保存到了剪贴板，可以使用打开文件对话框的从剪贴板打开...

如果补丁文件以.patch 或者 .diff 为扩展名的话，你可以选择直接右键点击该补丁文件，选择TortoiseSVN → 应用补丁... 在这种情况下，系统会提示你输入工作副本的位置。

这两种方法只是提供了做同一件事的不同方式。第一种方法，你先选择工作副本，然后浏览补丁文件。第二种方法，你先选择补丁文件，然后浏览工作副本。

一旦你选定了补丁文件和工作副本的位置，TortoiseMerge就会把布丁文件合并到你的工作副本中。系统会弹出一个小窗口列出所有被更改了的文件。依次双击每一个文件，检查所做的改变，然后保存合并后的文件。远程开发者的补丁现在已经应用到了你的工作副本上，你需要提交它以使每一个人都可以从代码库访问到这些修改。

远程开发者的补丁现在已经应用到了你的工作副本上，你需要提交它以使每一个人都可以从代码库访问到这些修改。

图 4.62. 评注/追溯对话框

如果对早期版本的修改不感兴趣，你可以设置从哪个版本开始追溯。如果你想追溯每一个版本，你可以把那个数值设置为1。

默认情况下追溯文件是使用 TortoiseBlame 来查看，突出显示不同的版本以使其更易于阅读。如果你想打印或者编辑追溯文件，选择 使用文本查看器查看追溯文件。

你可以指定处理行结束符和空白改变的方法。这些选项在 “行结束符和空白选项”一节 描述。默认是将行结束符和空白改变视为实际改变，但是如果你想忽略缩进改变和找到原始作者，那么可以在这里选择适当的处理方法。

You can include merge information as well if you wish, although this option can take considerably longer to retrieve from the server. When lines are merged from another source, the blame information shows the revision the change was made in the original source as well as the revision when it was merged into this file.

Once you press OK TortoiseSVN starts retrieving the data to create the blame file. Once the blame process has finished the result is written into a temporary file and you can view the results.

图 4.63. TortoiseBlame

TortoiseBlame,包含在TortoiseSVN中,使得追溯文件更加容易阅读。当你的鼠标在追溯信息列的某一行上盘旋时，所有和该列具有相同版本号的行都会用一个比较暗的背景色显示。同一作者修改的其他版本的行会用一个亮一些的背景色显示。如果你的显示设置为256色模式，那么颜色显示的可能不会很清楚。

如果在某一行上左击，具有同一版本号的所有行都会高亮显示，同一作者的其他版本的行会用一个更亮的颜色高亮显示。这个高亮具有粘性，也就是说允许你移动鼠标但原先高亮的地方仍然保持高亮。再次点击该版本将关闭高亮显示。

只要鼠标逗留在追溯信息列，版本注释(日志信息)就会作为提示出现。如果你想复制此版本的日志信息，使用在追溯信息列显示的右键菜单。

你可以在追溯报告里用编辑 → 查找...来搜索想要的内容。它允许你搜索版本号，作者还有文件的内容。这个搜索不包含日志信息－你可以在日志对话框里搜索日志信息。

你也可以使用 编辑 → 转到行 ... 来跳到指定行。

当鼠标滑过追溯信息列时，有个上下文菜单可以帮助你比较版本和检查历史，它用鼠标下方行的版本号作为参考版本。上下文菜单 → 追溯以前版本产生同一个文件的追溯报告，它使用以前的版本作为上限，给出了你看到最后修改之前的文件状态追溯报告。上下文菜单 → 显示修改启动差异察看器，显示在参考版本中的修改。上下文菜单 → 显示日志从参考版本开始显示版本日志。

如果您需要对最早和最新变化之处有一个更好的视觉指示，选择 View → Color age of lines。这将使用一个颜色渐变来显示新行为红色、旧行为蓝色。默认着色很浅，但你可以使用 TortoiseBlame 设置来改变它。

If you are using Merge Tracking and you requested merge info when starting the blame, merged lines are shown slightly differently. Where a line has changed as a result of merging from another path, TortoiseBlame will show the revision and author of the last change in the original file rather than the revision where the merge took place. These lines are indicated by showing the revision and author in italics. The revision where the merge took place is shown separately in the tooltip when you hover the mouse over the blame info columns. If you do not want merged lines shown in this way, uncheck the Include merge info checkbox when starting the blame.

If you want to see the paths involved in the merge, select View → Merge paths. This shows the path where the line was last changed, excluding changes resulting from a merge.

The revision shown in the blame information represents the last revision where the content of that line changed. If the file was created by copying another file, then until you change a line, its blame revision will show the last change in the original source file, not the revision where the copy was made. This also applies to the paths shown with merge info. The path shows the repository location where the last change was made to that line.

TortoiseBlame 设置可以使用 TortoiseBlame 选项卡上的 TortoiseSVN → 设置... 来访问。请参阅 “TortoiseBlame 的设置”一节。

One of the limitations of the Blame report is that it only shows the file as it was in a particular revision, and the last person to change each line. Sometimes you want to know what change was made, as well as who made it. If you right click on a line in TortoiseBlame you have a context menu item to show the changes made in that revision. But if you want to see the changes and the blame information simultaneously then you need a combination of the diff and blame reports.

在版本日志对话框里包含了以下几个选项支持你做这样的操作。

每个版本图节点代表版本库中的一个修订版本，在那儿你可以查看到树状的变化。不同类型的节点可通过形状和颜色来区分。形状是固定的，但颜色可以使用 TortoiseSVN → 设置

来设置。

注意默认情况下图示只显示被添加、复制或删除的项目点。非常状况下显示每一个项目版本将生成一个非常巨大的图示。如果你真的想看到 所有 发生更改的版本，在 查看 菜单和工具栏上的某个选项可以满足您的要求。

默认视图 (分组关闭) 的节点置放主要是让其垂直位置按照严格的版本顺序排列，所以你会对已完成项目的顺序产生一个视觉提示。同列中两个节点的顺序是非常明显的。当两个节点处于相邻列时偏移量会更小，因为不必防止节点相互重叠，因此顺序并不太明显。这种优化是必要的，可以将复杂的图示保持到一个合理的规模。请注意，这种排序使用了 较老 的一边的节点 边缘 作为参照，也就是当用底部最老的节点显示图示时的节点底部边缘。这种参考的边缘是很显著的，因为节点的形状并不都是相同的高度。

因为版本图经常很复杂，所以有很多方法剪裁视图。你可以在视图菜单或工具栏找到它们。

概览窗口可以使遍历大图更容易。它在小窗口中显示整个图形，高亮显示当前详细显示的部分。你可以通过拖曳高亮区域来改变当前详细显示的部分。

任何时候只要鼠标在版本框上滑过，都会显示该版本的日期、作者和备注信息。

选择两个版本(用ctrl+左击)，你可以在右键菜单下查看这两个版本的差异。你可以在分支的起始点查看差异，但一般你会在一个分支的结束点来查看，比如，在最新版本。

你可以用查看单一差异文件的方式来查看差异，它在单一的文件中显示差异。如果你选右键菜单 → 比较版本所有修改过的文件都会呈现在列表中。双击一个文件名可以返回文件版本号和他们差异。

如果右击一个版本你可以使用右键菜单 → 显示日志 来查看它的历史。

您也可以将所选修订版本的更改合并到不同的工作副本。可以通过文件夹选择对话框来确定合并到哪一个工作副本中，但是此操作没有确认对话框，也没有尝试测试合并的机会。合并到未修改的工作副本是一个好主意，这样当其行不通时您还可以恢复这些更改！当您想要将所选版本从一个分支合并到另一个分支时，这个功能很有用。

如果你想再次检查服务器是否有新的消息，可以使用 F5 键来刷新视图。如果使用日志缓存(默认启用)，这将会检查版本库是否有新的提交并且只获取新的。如果日志缓存处于离线模式，这将会尝试回到在线模式。

如果您正在使用日志缓存并且认为消息内容或作者可能已更改，您应该使用日志对话框来刷新所需消息。由于修订版本图形起于版本库根目录，我们将不得不使整个日志缓存失效，而重新填满它可能会花上非常长的时间。

一个大的树结构可能难以导航，有时您会想隐藏其中一部分，或者把它拆分成更小的树结构集合。如果您将鼠标悬停于节点链接进入或离开节点的地方，您将会看到一个或更多的弹出式按钮来允许您这样做。

在减号上单击收起关联子树。

点击加号按钮来展开折叠的树结构。当一个树结构已经折叠时，此按钮将保持可见以表明已隐藏的子树。

点击十字按钮来拆开所连接的子树，并在图形上将其显示为单独的树。

点击圆形按钮以重新连接一个拆开的树。当一个树已被拆离时，此按钮将保持可见以表明有一个单独的子树。

点击图形背景以获取主上下文菜单，它可提供选项来 全部展开 和 全部拼合。如果没有分支被折叠或拆开，该上下文菜单将不会被显示。

Sometimes you have a working copy which you want to convert back to a normal folder without the .svn directory. All you need to do is delete the .svn directory from the working copy root.

Alternatively you can export the folder to itself. In Windows Explorer right drag the working copy root folder from the file pane onto itself in the folder pane. TortoiseSVN detects this special case and asks if you want to make the working copy unversioned. If you answer yes the control directory will be removed and you will have a plain, unversioned directory tree.

您可以在 TortoiseSVN 中为您的选择集成一个错误跟踪工具。为此，您必须定义一些属性，用 bugtraq: 开头。它们必须设置于文件夹: (“项目设置”一节)

图 4.68. The Bugtraq Properties Dialog

When you edit any of the bugtraq properties a special property editor is used to make it easier to set appropriate values.

有两种方式将问题跟踪器集成于 TortoiseSVN。一种基于简单的字符串，另一种基于 正则表达式。两种方法使用的属性为:

如果同时设置了bugtraq:message和bugtraq:logregex属性，日志正则表达式会优先使用。

一些 tsvn: 属性需要 true/false 值。TortoiseSVN 也理解 yes 是 true 的同义词，no 是 false 的同义词。

当你使用TortoiseSVN在工作副本中新建一个子目录， 上层目录的所有项目属性都会自动的被继承。.

This issue tracker integration is not restricted to TortoiseSVN; it can be used with any Subversion client. For more information, read the full Issue Tracker Integration Specification in the TortoiseSVN source repository. (“许可协议”一节 explains how to access the repository.)

前一节介绍了在日志信息中添加问题单信息，那如何从问题跟踪器中获取信息呢？提交对话框有一个 COM 接口，可允许集成一个能够跟跟踪器交互的外部程序。通常，您可能想查询跟踪器以得到分配给您的开放问题列表，以便于您能选取提交中正在解决的问题。

Any such interface is of course highly specific to your issue tracker system, so we cannot provide this part, and describing how to create such a program is beyond the scope of this manual. The interface definition and sample plugins in C# and C++/ATL can be obtained from the contrib folder in the TortoiseSVN repository. (“许可协议”一节 explains how to access the repository.) A summary of the API is also given in 第 7 章 IBugtraqProvider 接口. Another (working) example plugin in C# is Gurtle which implements the required COM interface to interact with the Google Code issue tracker.

为便于说明，假设您的系统管理员已向您提供了已安装的问题跟踪器插件，并且您已让一些工作副本使用了 TortoiseSVN 设置对话框中的插件。当您从已分配了插件的工作副本中打开提交对话框时，您会在对话框顶部看到一个新的按钮。

图 4.69. 问题跟踪查询对话框示例

在此示例中，您可以选择一个或多个开放问题。然后，该插件可以生成特殊格式的文本，并将其添加到您的日志消息中。