选择您的用户界面语言。当然，您必须先安装相应的语言包才能获得除默认英语之外的其他 UI 语言。

TortoiseSVN 会定期联系其下载站点，查看是否有更新版本的程序可用。如果有，它将在提交对话框中显示一个通知链接。如果您想立即获得答案，请使用 立即检查。新版本不会被下载；您只会收到一个信息对话框，告诉您新版本可用。

TortoiseSVN 有三个默认安装的自定义声音。

您可以使用 Windows 控制面板选择不同的声音（或完全关闭这些声音）。配置 是控制面板的快捷方式。

在 Windows Vista 及更高版本系统上，这将控制对话框是否使用 Aero 样式。

在 Windows 7 上，您可以创建一个库，用于对系统中各个位置的多个工作副本进行分组。

全局忽略模式用于防止未版本化的文件显示在例如提交对话框中。与模式匹配的文件也会被导入忽略。通过输入名称或扩展名来忽略文件或目录。模式之间用空格隔开，例如 bin obj *.bak *.~?? *.jar *.[Tt]mp。这些模式不应包含任何路径分隔符。还要注意，无法区分文件和目录。阅读 名为“忽略列表中的模式匹配”的部分，以获取有关模式匹配语法的更多信息。

请注意，您在此处指定的忽略模式也会影响运行在您的 PC 上的其他 Subversion 客户端，包括命令行客户端。

此忽略模式将影响您所有的项目。它不是版本化的，因此不会影响其他用户。相反，您还可以使用版本化的 svn:ignore 或 svn:global-ignores 属性来排除版本控制中的文件或目录。阅读 名为“忽略文件和目录”的部分 以获取更多信息。

此选项告诉 TortoiseSVN 在执行检出或更新时将文件日期设置为最后提交时间。否则，TortoiseSVN 将使用当前日期。如果您正在开发软件，通常最好使用当前日期，因为构建系统通常会查看日期戳以确定哪些文件需要编译。如果您使用 “最后提交时间” 并恢复到旧的文件版本，您的项目可能无法按预期编译。

使用 编辑 直接编辑 Subversion 配置文件。某些设置无法直接由 TortoiseSVN 修改，需要在此处设置。有关 Subversion config 文件的更多信息，请参阅 运行时配置区域 。关于 自动属性设置 的部分特别有趣，并且在此处配置。请注意，Subversion 可以从多个地方读取配置信息，您需要知道哪个优先级最高。参考 配置和 Windows 注册表 以了解更多信息。

此选项告诉 TortoiseSVN 在更新工作副本时始终将本地修改应用于 svn:externals 属性。

版本图试图通过区分主干、分支和标签来显示更清晰的仓库结构。由于 Subversion 中没有内置这种分类，因此此信息是从路径名中提取的。默认设置假设您使用 Subversion 文档中建议的传统英文名称，但您的使用方式可能有所不同。

在提供的三个框中指定用于识别这些路径的模式。模式将不区分大小写匹配，但您必须以小写形式指定它们。通配符 * 和 ? 将按预期工作，您可以使用 ; 分隔多个模式。不要包含任何额外的空格，因为它将包含在匹配规范中。

颜色在修订图中用于指示节点类型，即节点是添加、删除还是重命名。为了帮助挑选节点分类，您可以允许修订图混合颜色以指示节点类型和分类。如果选中该框，则使用混合。如果未选中该框，则颜色仅用于指示节点类型。使用颜色选择对话框分配使用的特定颜色。

在单独的进程 (TSVNCache.exe) 中缓存所有状态信息。该进程监视所有驱动器以进行更改，并在工作副本内的文件被修改时再次获取状态。该进程以最低优先级运行，因此其他程序不会因其而占用资源。这也意味着状态信息不是 实时 的，但叠加可能需要几秒钟才能更改。

优点：叠加会递归地显示状态，即如果工作副本深处的文件被修改，则从工作副本根目录到该文件的文件夹也会显示修改叠加。由于该进程可以向 shell 发送通知，因此左侧树视图上的叠加通常也会更改。

缺点：即使您没有使用项目，该进程也会不断运行。它还会使用大约 10-50 MB 的内存，具体取决于工作副本的数量和大小。

缓存直接在 shell 扩展 dll 内部完成，但仅针对当前可见的文件夹。每次您导航到另一个文件夹时，都会再次获取状态信息。

优点：只需要很少的内存（大约 1 MB 的内存），并且可以 实时 显示状态。

缺点：由于只缓存一个文件夹，因此叠加不会递归地显示状态。对于大型工作副本，在资源管理器中显示文件夹可能比使用默认缓存花费更多时间。此外，mime 类型列不可用。

使用此设置，TortoiseSVN 不会在资源管理器中获取任何状态。因此，文件不会获得叠加，并且文件夹只有在版本化的情况下才会获得“正常”叠加。不会显示其他叠加，也不会提供额外的列。

优点：绝对不使用额外的内存，并且在浏览时不会减慢资源管理器的速度。

缺点：资源管理器中不会显示文件和文件夹的状态信息。要查看您的工作副本是否已修改，您必须使用 “检查修改” 对话框。

每当您检出工作副本、合并更改或使用存储库浏览器时，TortoiseSVN 都会记录最近使用的 URL，并在组合框中提供它们。有时该列表会因过时的 URL 而变得杂乱，因此定期清除它很有用。

如果您想从某个组合框中删除单个项目，您可以在原地进行操作。只需单击箭头以下拉组合框，将鼠标悬停在要删除的项目上，然后键入 Shift+Del。

TortoiseSVN 会存储您输入的最近提交日志消息。这些消息按存储库存储，因此如果您访问多个存储库，此列表可能会变得很大。

TortoiseSVN 会缓存由“显示日志”对话框获取的日志消息，以便在您下次显示日志时节省时间。如果其他人编辑了日志消息，而您已经缓存了该消息，则在清除缓存之前，您将看不到更改。日志消息缓存已在 日志缓存 选项卡上启用。

许多对话框会记住您上次使用的大小和屏幕位置。

当您使用 Subversion 服务器进行身份验证时，用户名和密码会缓存在本地，因此您不必一直输入它们。出于安全原因，或者因为您想以不同的用户名访问存储库，您可能希望清除它……约翰知道您在使用他的电脑吗？

如果您只想清除特定服务器的认证数据，请使用 清除... 按钮，而不是 全部清除 按钮。

TortoiseSVN 会记录所有写入其进度对话框的内容。这在您想要检查最近更新命令中发生了什么时非常有用。

日志文件长度有限，当它变得太大时，最旧的内容将被丢弃。默认情况下会保留 4000 行，但您可以自定义该数字。

从这里您可以查看日志文件内容，也可以清除它。

在请求日志数据时启用日志缓存。如果选中，将在可用时从缓存中检索数据，并且任何不在缓存中的消息将从服务器检索并添加到缓存中。

如果禁用缓存，数据将始终直接从服务器检索，而不是存储在本地。

有时您可能需要连接到使用相同 URL 的所有存储库的服务器。旧版本的 svnbridge 会这样做。如果您需要访问此类存储库，则需要选中此选项。如果您不需要，请取消选中以提高性能。

一些托管服务为其所有存储库提供相同的 UUID。您甚至可能通过复制存储库文件夹来创建新的存储库来做到这一点。由于各种原因，这是一个坏主意 - UUID 应该是 唯一的。但是，如果您选中此框，日志缓存仍然可以在这种情况下工作。如果您不需要，请取消选中以提高性能。

如果您离线工作，或者存储库服务器宕机，日志缓存仍然可以用来提供缓存中已有的日志消息。当然，缓存可能不是最新的，因此您可以选择是否使用此功能。

当从缓存中获取日志数据而不联系服务器时，使用这些消息的对话框将在其标题栏中显示离线状态。

当您调用日志对话框时，您通常希望联系服务器以检查是否有更新的日志消息。如果此处设置的超时时间非零，则只有在上次联系后超时时间过去时才会联系服务器。如果您经常打开日志对话框并且服务器速度很慢，这可以减少服务器往返次数，但显示的数据可能不是完全最新的。如果您想使用此功能，我们建议使用 300（5 分钟）的值作为折衷方案。

如果您浏览许多存储库，您将积累大量日志缓存。如果您没有积极使用它们，缓存不会增长很大，因此 TortoiseSVN 默认情况下会在一段时间后清除它们。使用此项来控制缓存清除。

较大的缓存重新获取成本更高，因此 TortoiseSVN 只清除小缓存。使用此值微调阈值。

偶尔，缓存会出现问题并导致崩溃。如果发生这种情况，缓存通常会自动删除以防止问题再次发生。如果您使用的是不太稳定的夜间构建版本，您可能选择保留缓存。

在提交对话框显示之前调用。如果您想使用此钩子修改版本控制文件并影响需要提交的文件列表和/或提交消息，则可以使用它。但是，您应该注意，由于钩子是在早期阶段调用的，因此无法获得要提交的所有对象的完整列表。

如果指定了此项，则提交对话框将显示一个按钮 运行钩子，单击该按钮将运行指定的钩子脚本。钩子脚本接收所有已选中文件和文件夹的列表以及提交消息（如果有）。

在用户单击提交对话框中的 确定 按钮后，并在提交对话框关闭之前调用。此钩子获取所有已选中文件的列表。如果钩子返回错误，则提交对话框将保持打开状态。

如果返回的错误消息包含以换行符分隔的行上的路径，则在显示错误消息后，这些路径将在提交对话框中被选中。

在用户单击提交对话框中的 确定 按钮后，并在实际提交开始之前调用。此钩子具有将要提交的确切内容的列表。

在提交成功完成之后调用。

在显示更新到修订版对话框之前调用。

在实际的 Subversion 更新或切换开始之前调用。

在更新、切换或检出完成之后调用（无论成功与否）。

在尝试联系存储库之前调用。在五分钟内最多调用一次。

在尝试锁定文件之前调用。

在文件被锁定之后调用。

PATH MESSAGEFILE CWD

PATH MESSAGEFILE CWD

PATH MESSAGEFILE CWD

PATH DEPTH MESSAGEFILE CWD

PATH DEPTH MESSAGEFILE REVISION ERROR CWD

PATH CWD

PATH DEPTH REVISION CWD

PATH DEPTH REVISION ERROR CWD RESULTPATH

此脚本不传递任何参数。您可以通过将自定义参数附加到脚本路径来传递它。

PATH LOCK FORCE MESSAGEFILE CWD

PATH LOCK FORCE MESSAGEFILE ERROR CWD

一个指向临时文件的路径，该文件包含以 UTF-8 编码启动操作的所有路径。每个路径都在临时文件中的单独一行。

请注意，对于远程执行的操作，例如在存储库浏览器中，这些路径不是本地路径，而是受影响项目的 URL。

执行提交/更新的深度。

可能的值是

包含提交日志消息的文件的路径。该文件以 UTF-8 编码包含文本。在成功执行 start-commit 钩子后，会读取回日志消息，让钩子有机会修改它。

应执行更新的存储库修订版或提交完成后。

锁定时为 true，解锁时为 false。

如果操作是强制执行的，则为 true，否则为 false。

包含错误消息的文件路径。如果没有错误，则文件将为空。

运行脚本的当前工作目录。它被设置为所有受影响路径的公共根目录。

指向临时文件的路径，该文件包含以 UTF-8 编码的所有以某种方式被操作触及的路径。每个路径在临时文件中单独占一行。

TortoiseBlame 可以使用背景颜色来指示文件中行的年龄。您可以通过指定最新和最旧修订版的颜色来设置端点，TortoiseBlame 会根据每行指示的存储库修订版在这两种颜色之间进行线性插值。

您可以指定不同的颜色用于定位器栏。默认情况下，定位器栏使用强对比度，同时保持主窗口背景亮度，以便您仍然可以阅读文本。

您可以选择用于显示文本的字体，以及要使用的字号。这适用于文件内容，以及左侧窗格中显示的作者和修订版信息。

定义在文件中找到制表符字符时要使用的扩展空间数。

TortoiseUDiff 默认使用的颜色通常是可以的，但您可以在此处配置它们。

您可以选择用于显示文本的字体，以及要使用的字号。

定义在文件差异中找到制表符字符时，用于扩展的空格数。

有时，多个用户在同一台计算机上使用同一个帐户。在这种情况下，不希望保存身份验证数据。将此值设置为 false 将禁用身份验证对话框中的 保存身份验证 按钮。

如果更新从存储库添加一个新文件，而该文件在本地工作副本中已存在为未版本控制的文件，则默认操作是保留本地文件，将其显示为来自存储库的新文件的（可能）修改版本。如果您希望 TortoiseSVN 在这种情况下创建冲突，请将此值设置为 false。

与资源管理器一样，TortoiseSVN 在打开上下文菜单时按住 Shift 键，将显示其他命令。要强制 TortoiseSVN 始终显示这些扩展命令，请将此值设置为 true。

编辑器显示自动完成弹出窗口的最小字符数。默认值为 3。

提交信息编辑器中显示的自动完成列表显示了要提交的文件的名称。要将这些名称（不带扩展名）也包括在内，请将此值设置为 true。

默认情况下，固定到特定修订版的外部文件将被阻止选择进行提交。这是因为除非调整外部文件的固定修订版，否则后续更新将再次还原这些更改。

如果您仍然希望提交对这些外部文件的更改，请将此值设置为 false。

如果您不希望资源管理器在另一个 TortoiseSVN 命令运行时（例如更新、提交等）更新状态覆盖，请将此值设置为 true。

要为 TSVNCache 程序添加缓存托盘图标，请将此值设置为 true。这实际上只对开发人员有用，因为它允许您优雅地终止程序。

TortoiseSVN 添加到 Windows 资源管理器详细信息视图中的额外列通常仅在工作副本中处于活动状态。如果您希望这些列在任何地方都可用，而不仅仅是在工作副本中，请将此值设置为 true。请注意，额外列仅在 XP 中可用。Vista 及更高版本不再支持该功能。但是，一些第三方资源管理器替换程序即使在 Windows 版本高于 XP 的情况下也支持这些功能。

您可以在此处指定 Subversion 配置文件的不同位置。这将影响所有 TortoiseSVN 操作。

在 TortoiseSVN 中的大多数对话框中，您可以使用 Ctrl+Enter 关闭对话框，就像您单击了“确定”按钮一样。如果您不希望这样做，请将此值设置为 false。

如果您希望为每个显示用于启动 TortoiseProc.exe 的命令行的命令弹出一个对话框，请将其设置为 true。

如果您希望 TortoiseSVN 在执行期间打印调试消息，请将其设置为 true。这些消息只能使用特殊的调试工具捕获。

对话框标题的默认格式（值为 0）为 url/path - name of dialog - TortoiseSVN。如果您将此值设置为 1，则格式将更改为 name of dialog - url/path - TortoiseSVN。

TortoiseSVN 允许您指定外部差异查看器。但是，大多数此类查看器不适合变更归责（参见“归责差异”部分），因此您可能希望在这种情况下回退到 TortoiseMerge。为此，请将此值设置为 true。

此值指定对话框必须靠近边框多少像素才能粘贴到边框。默认值为 3。要禁用此值，请将其设置为零。

某些应用程序会在不通知的情况下更改文件名的大小写，但这些更改实际上既不必要也不需要。例如，从 file.txt 更改为 FILE.TXT 不会影响正常的 Windows 应用程序，但 Subversion 在这些情况下区分大小写。因此，TortoiseSVN 会自动修复此类大小写更改。

如果您不希望 TortoiseSVN 自动为您修复此类大小写更改，则可以将此值设置为 false。

在各种对话框（例如，提交、检查修改、添加、还原等）中使用的状态列表控件使用整行选择（即，如果您选择一个条目，则会选择整行，而不仅仅是第一列）。这很好，但选定的行也会覆盖右下角的背景图像，这可能看起来很丑陋。要禁用整行选择，请将此值设置为 false。

此选项决定如何将各种 TortoiseSVN 对话框和窗口的 Win7 任务栏图标分组在一起。此选项对 Vista 无效！

如果选项 GroupTaskbarIconsPerRepo 设置为 0（见上文），则此选项无效。

如果此选项设置为 true，则 Win7 任务栏上的每个图标都会显示一个小的彩色矩形叠加层，指示对话框/窗口所使用的仓库。

图 4.98. 带有仓库颜色叠加层的任务栏分组

如果此选项设置为 false，则在更新期间会分别显示每个 svn:externals。

如果此选项设置为 true（默认值），则仅当外部文件受更新影响（即以某种方式更改）时，才会显示外部文件的更新信息。否则，与普通文件和文件夹一样，不会显示任何内容。

如果此选项设置为 true，则取消批准运行挂钩脚本的对话框将显示一个错误对话框，指示用户已取消。

默认情况下，TortoiseSVN 始终在更新时包含外部文件。这避免了工作副本不一致的问题。但是，如果您设置了大量外部文件，更新可能需要相当长的时间。将此值设置为 false 以运行默认更新，不包含外部文件。要包含外部文件进行更新，请运行 更新到版本... 对话框或将此值再次设置为 true。

当从合并向导启动日志对话框时，已合并的修订版将以灰色显示，但超出分支创建点的修订版也会显示。这些修订版以黑色显示，因为它们无法合并。

如果将此选项设置为 true，则 TortoiseSVN 会尝试查找创建分支的修订版，并隐藏所有超出该修订版的修订版。由于这可能需要相当长的时间，因此默认情况下禁用此选项。

在日志对话框中选择多个修订版时，用于日志消息的格式字符串。

您可以在格式字符串中使用以下占位符

日志对话框以粗体显示工作副本路径所在的修订版。但这需要日志对话框获取该路径的状态。由于对于非常大的工作副本，这可能需要一段时间，因此您可以将此值设置为 false 以停用此功能。

如果可能，URL 和路径的组合框将显示以前使用过的 URL/路径的历史记录。此设置控制保存和显示的先前项目数量。默认值为 25 个项目。

当您从另一个分支合并修订版，并且合并跟踪信息可用时，将收集您合并的修订版的日志消息以构成提交日志消息。预定义的字符串用于分隔合并修订版的各个日志消息。如果您愿意，可以将其设置为包含您选择的分割符字符串的值。

通过设置为 true，您可以设置合并选项对话框中 允许混合修订版（不推荐）复选框的默认值。在配置此设置之前，请注意混合修订版工作副本合并的限制和潜在问题。

如果您想一次显示比此设置指定的更多项目的差异，则会先显示一个警告对话框。默认值为 10。

TortoiseSVN 每周大约检查一次是否有新版本可用。如果找到更新的版本，提交对话框将显示一个带有该信息的链接控件。如果您更喜欢旧的行为，即弹出对话框通知您更新，请将此值设置为 true。

存储库浏览器尝试获取由配置了 SVNParentPath 指令的 SVN 服务器生成的网页，以获取所有存储库的列表。要禁用此行为，请将此值设置为 false。

此选项启用提交消息编辑框的双向模式。如果启用，则会正确完成从右到左的语言文本编辑。由于此功能成本很高，因此默认情况下处于禁用状态。您可以通过将此值设置为 true 来启用它。

此选项启用在 Scintilla 控件中使用 Direct2D 加速绘制，该控件用作例如提交对话框中的编辑框，以及用于统一 diff 查看器。但是，对于某些显卡，这有时无法正常工作，因此输入文本的游标并不总是可见的。如果发生这种情况，您可以通过将此值设置为 false 来关闭此功能。

此参数指定如果提交由于过时错误而失败，TortoiseSVN 的行为方式。

如果设置为 true，TortoiseSVN 将在发生错误或警告时播放系统声音，或其他需要您注意的重要情况。如果要使 TortoiseSVN 保持静音，请将其设置为 false。请注意，项目监视器有其自己的播放声音设置，您可以在其设置对话框中进行配置。

TortoiseSVN 使用其资源管理器上下文菜单项的加速键。由于这会导致加速键重复（例如，SVN Commit 具有 Alt-C 加速键，但资源管理器的 Copy 条目也是如此）。如果您不想或不需要 TortoiseSVN 条目的加速键，请将此值设置为 false。

如果您使用的是除 Windows 资源管理器以外的其他工具，或者您在显示上下文菜单时遇到问题，这将很有用。如果您不希望 TortoiseSVN 显示外壳上下文菜单项的图标，请将此值设置为 false。要再次显示图标，请将此值设置为 true。

如果您不想让 TortoiseSVN 在其自己的对话框中显示上下文菜单的图标，请将此值设置为 false。

如果您不想让项目监视器在检测到新提交时显示通知弹出窗口，请将此值设置为 false。

提交和日志对话框在提交消息中使用样式（例如粗体、斜体）（有关详细信息，请参阅 名为“提交日志消息”的部分）。如果您不想这样做，请将该值设置为 false。

此值包含 TortoiseSVN 用于下载文本文件以查找是否有可用更新的 URL。这可能对不想让用户更新 TortoiseSVN 直到他们批准的公司管理员有用。

标准编辑控件不会在路径和 URL 中找到的正斜杠处停止。TortoiseSVN 对编辑控件使用自定义断字过程。如果您不希望这样做，而是使用默认设置，请将此值设置为 0。如果您只想在组合框中的编辑控件中使用默认设置，请将此值设置为 1。

TortoiseSVN 每周大约检查一次是否有新版本可用。如果您不想让 TortoiseSVN 进行此检查，请将此值设置为 false。