本文共 2866 字，大约阅读时间需要 9 分钟。

TortoiseSVN 使用指南

前言

本文内容来源于TortoiseSVN软件的帮助文档，旨在为用户提供一个快速入门的Subversion版本控制工具使用指南。

一、基础理论

在使用Subversion之前，了解其工作原理和基本术语是非常重要的。

1. 库（Repository）

Subversion使用一个中央数据库存储所有版本控制文件及其完整历史记录。这个数据库称为存储库。存储库通常位于运行Subversion服务器程序的文件服务器上，并根据客户端请求提供内容。存储库是所有数据的最终主副本，因此在备份时，备份存储库是最重要的。

2. 工作副本（Working Copy）

这是您进行实际工作的地方。每个开发人员都可以在本地PC上创建一个工作副本，通常也称为沙盒。您可以从存储库中提取最新版本，在不影响其他人的情况下进行修改，然后将修改提交到存储库。

工作副本不包含项目的历史记录，但在进行修改之前，它确实保留了存储库中文件的副本。这使得检查修改非常容易。

需要注意的是，TortoiseSVN是一个Shell扩展工具，因此在使用它之前，请确保先启动Windows资源管理器。

二、小试牛刀

本节将向您展示如何在小型测试存储库中使用一些常用功能。虽然这只是一个快速入门指南，但我们建议您在阅读完本文后，继续深入了解更多内容。

1. 建立仓库

对于一个真实项目，您需要在一个安全的位置设置一个存储库，并使用Subversion服务器进行控制。本文将使用Subversion的本地存储库功能，这种方式允许您直接在硬盘驱动器上创建存储库，而无需使用服务器。

首先，在您的PC上创建一个新的空目录，假设名称为C:\svn_repos。然后右键单击新文件夹，从上下文菜单中选择TortoiseSVN→Create Repository here…。接下来，您可以通过单击Create folder structure按钮来创建默认的内部文件夹结构。

注意：本地存储库功能对于测试和评估非常有用，但在团队协作中绝对不应使用网络共享存储库。这样做会导致数据丢失。

2. 导入工程

现在我们已经有了一个存储库，但目前是空的。假设您想将C:\Projects\Widget1中的文件添加到存储库中。打开资源管理器，右键单击Widget1文件夹，从上下文菜单中选择TortoiseSVN→Import…。这将打开一个对话框，允许您指定存储库的URL。在本例中，存储库的URL为file://C:/svn_repos/trunk，项目名称为Widget1。请注意，文件后有三个斜杠，并且在整个URL中使用正斜杠。

对话框中的“Import Message”框允许您输入一条描述您正在执行的消息。输入一个简单的消息，如“导入Widget1项目”，然后单击OK按钮即可将文件夹添加到存储库中。

3. 检出工作备份（Checkout）

现在我们的存储库中有一个项目，我们需要创建一个工作副本用于日常工作。请注意，导入文件夹的操作不会自动将其转换为工作副本。Subversion术语中，创建工作副本的操作称为Checkout。我们将从存储库的C:\svn_repos\trunk\Widget1中检出文件夹C:\Projects\Widget1-Dev。创建该文件夹后，右键单击它，从上下文菜单中选择TortoiseSVN→Checkout…。在对话框中输入要检出的URL，单击OK按钮即可开始检出过程。

注意：在默认设置中，检出菜单项不在TortoiseSVN子菜单中，而是显示在资源管理器顶部菜单中。子菜单中未显示的TortoiseSVN命令带有SVN前缀，如SVN Checkout…。

检出完成后，您会发现文件夹的外观与原始文件夹不同。每个文件的左下角都有一个绿色的复选标记，这是TortoiseSVN的状态图标。绿色表示文件与存储库中的版本相同。

4. 做出修改

假设您已经创建了工作副本C:\Projects\Widget1-Dev，在其中对Widget1.c和ReadMe.txt进行了修改。这两个文件的图标现在显示为红色，表示已在本地进行了修改。

如果您想查看具体的更改，可以右键单击其中一个文件，从上下文菜单中选择TortoiseSVN→Diff。这将打开TortoiseSVN的文件比较工具，确切显示更改的行。

当您对更改感到满意时，可以将修改提交到存储库。右键单击Widget1-Dev文件夹，从上下文菜单中选择TortoiseSVN→Commit。提交对话框会列出所有更改的文件，每个文件都有一个复选框。选择要提交的文件，然后输入一条描述更改的消息，单击OK按钮即可完成提交。

5. 添加更多文件

随着项目的发展，您可能需要添加新文件。假设您在Extras.c中添加了一些新功能，并在现有的Makefile中添加了引用。右键单击该文件夹，从上下文菜单中选择TortoiseSVN→Add。对话框将显示所有未版本控制的文件，您可以选择要添加的文件。

添加文件的另一种方法是右键单击文件本身，从上下文菜单中选择TortoiseSVN→Add。

提交文件夹时，新文件将显示为已添加，而现有文件则显示为已修改。双击修改后的文件以查看具体的更改。

6. 查看工程历史

“日志”对话框是TortoiseSVN最有用的功能之一。它允许您查看您对文件或文件夹进行的所有提交的列表，并显示您输入的详细提交消息。

打开“日志”对话框后，顶部窗格显示已提交修订的列表和提交消息的开头。选择任意一个修订版，中间窗格将显示该修订版的完整日志消息，底部窗格显示已更改文件和文件夹的列表。

每个窗格都有一个上下文菜单，为您提供更多使用信息的方式。底部窗格中，您可以双击一个文件以确切查看该修订版中进行的哪些更改。

7. 撤销更改

所有版本控制系统都允许您撤销先前所做的更改。TortoiseSVN同样提供了这个功能。

如果要撤销尚未提交的更改并将文件恢复到开始编辑前的状态，可以选择TortoiseSVN→Revert。这将放弃您的更改（请确保已保存到回收站），并还原为最初的提交版本。

如果您只想撤销某些更改，可以使用TortoiseMerge查看差异并选择性地还原更改的行。

如果要撤消特定修订版的影响，请从“日志”对话框开始，查找有问题的修订版。选择上下文菜单中的“Revert changes from this revision”，这些更改将被撤消。

总结

以下是一些常用操作：

• 建立仓库：TortoiseSVN→Create Repository here…
• 导入工程：TortoiseSVN→Import…
• 检出工作区：TortoiseSVN→Checkout…
• 查看差异：TortoiseSVN→Diff
• 提交修改：TortoiseSVN→Commit
• 添加文件：TortoiseSVN→Add
• 撤销更改：TortoiseSVN→Revert