手把手教你使用TortoiseSVN：从安装到基本操作 – wiki基地

---

手把手教你使用TortoiseSVN：从安装到基本操作

在软件开发、文档编写、设计创作等领域，版本控制系统扮演着至关重要的角色。它能帮助个人和团队追踪文件的历史变化、协调多人协作、避免冲突、回溯错误版本，极大地提高了工作效率和项目的可控性。Subversion (SVN) 是一个广泛使用的开源版本控制系统，而 TortoiseSVN 则是 SVN 在 Windows 平台上的一个优秀客户端工具，它以其直观易用的图形界面集成了 SVN 的各项功能，让版本控制操作变得像文件管理一样简单。

本文将手把手教你如何安装 TortoiseSVN，并详细介绍其最常用的基本操作，帮助你快速上手，享受版本控制带来的便利。

第一部分：初识与安装 TortoiseSVN

1. 什么是版本控制？为什么需要它？

想象一下你正在编写一个重要的文档或代码项目。你可能会不断修改、保存，为了保留不同阶段的版本，你可能会创建像 “文档_v1.0.doc”、”文档_v1.1_修改.doc”、”文档_最终版_真正最终版.doc” 这样的文件。当多人协作时，这种情况会变得极其混乱，难以同步彼此的修改，容易覆盖文件或产生冲突。

版本控制系统正是为了解决这些问题而生。它是一个记录文件内容变化的系统，可以让你随时查看文件的任何一个历史版本、比较不同版本之间的差异、恢复到旧版本。对于团队协作，它提供了一个中心化的（或分布式的）仓库，允许多人同时修改项目文件，并提供机制来合并各自的修改，解决冲突。

2. SVN (Subversion) 简介

SVN 是一个集中式的版本控制系统。它的核心是一个中央仓库（Repository），所有的文件和历史记录都存储在这里。开发者通过客户端连接到这个中央仓库，将文件“检出”（Checkout）到本地进行修改，然后将修改“提交”（Commit）回仓库。其他开发者可以通过“更新”（Update）操作获取仓库中最新的变化。

3. 什么是 TortoiseSVN？为什么选择它？

TortoiseSVN 是一个自由、开源的 SVN 客户端，它作为 Windows 的外壳扩展（Shell Extension）集成到文件管理器（如 Windows Explorer）中。这意味着你可以在文件的右键菜单中直接访问 SVN 的各种功能，而无需打开独立的应用程序或记住复杂的命令行指令。其直观的图标覆盖（Icon Overlay）也能让你一目了然地看到文件的版本控制状态。对于不习惯命令行的 Windows 用户来说，TortoiseSVN 是使用 SVN 的首选工具。

4. 安装 TortoiseSVN

安装 TortoiseSVN 是非常直接的过程。

• 步骤 1：下载安装包
  访问 TortoiseSVN 的官方网站（通常是 https://tortoisesvn.net/downloads.html）。在下载页面，你需要选择适合你 Windows 操作系统版本的安装包。大多数现代 Windows 系统是 64 位的，因此请下载 64-bit installer。如果你的系统是 32 位的，则下载 32-bit installer。你通常可以在“此电脑”或“计算机”属性中查看系统类型。同时，官方网站通常也提供语言包下载，你可以下载中文语言包（Language Pack）以便使用中文界面。先下载安装包，再下载语言包。

• 步骤 2：运行安装程序
  找到下载好的 .msi 安装文件，双击运行。如果出现用户账户控制（UAC）提示，请点击“是”允许程序运行。

• 步骤 3：进入安装向导
  安装向导启动后，你会看到欢迎界面。点击“Next”继续。

• 步骤 4：阅读并接受许可协议
  仔细阅读许可协议（License Agreement），如果你同意条款，勾选“I accept the terms in the License Agreement”，然后点击“Next”。

• 步骤 5：选择安装组件
  在这一步，你可以选择要安装的组件。默认选项通常已经足够日常使用。

  • TortoiseSVN core: 核心组件，必须安装。
  • Command line client tools: 命令行客户端工具。虽然 TortoiseSVN 是图形界面工具，但安装命令行工具有时也很有用（例如用于自动化脚本）。推荐勾选安装。
  • Dictionaries: 拼写检查字典。根据需要选择。
  • Language packs: 如果你之前下载了语言包，可以暂时不安装这里列出的默认语言包，稍后安装下载的中文语言包。
    选择完毕后，点击“Next”。

• 步骤 6：选择安装位置
  选择 TortoiseSVN 的安装目录。默认位置通常是 C:\Program Files\TortoiseSVN\ (64位系统) 或 C:\Program Files (x86)\TortoiseSVN\ (32位系统)。如果你没有特殊需求，保持默认即可。点击“Next”。

• 步骤 7：开始安装
  安装程序会显示即将进行的安装摘要。点击“Install”开始安装过程。

• 步骤 8：完成安装
  安装过程可能需要几分钟。完成后，向导会提示安装成功。通常会有一个选项问你是否要重启计算机。强烈建议勾选“Restart the computer now”并点击“Finish”重启计算机。 TortoiseSVN 作为外壳扩展，需要重启文件浏览器（explorer.exe）才能完全生效，而重启计算机是最彻底的方式。如果不方便立即重启，也可以选择“I will restart the computer later”，但在那之前，TortoiseSVN 的右键菜单和图标可能无法正常显示。

• 步骤 9：安装语言包 (可选)
  如果之前下载了中文语言包 .msi 文件，重启计算机后，双击运行语言包安装程序。它会自动检测 TortoiseSVN 的安装位置并进行安装。安装完成后，右键点击任意文件夹，选择 TortoiseSVN -> Settings。在设置窗口左侧选择 General，然后在右侧的 Language 下拉菜单中选择“中文(简体,中国)”或你安装的语言，点击“OK”保存设置。可能需要再次重启文件浏览器（可以注销或重启计算机）才能看到界面语言的改变。

至此，TortoiseSVN 已经成功安装到你的计算机上。

第二部分：连接仓库与基本操作

安装完成后，你就可以开始使用 TortoiseSVN 连接 SVN 仓库并进行版本控制操作了。

1. 理解工作副本 (Working Copy)

在使用 SVN 时，你不会直接在中央仓库中修改文件。你需要从仓库中获取一份文件的本地拷贝，这被称为“工作副本”（Working Copy）。所有的修改都在你的工作副本中进行。修改完成后，你需要将这些修改同步回仓库。

2. 检出仓库 (Checkout)

首次获取仓库内容到本地时，你需要执行“检出”（Checkout）操作。

• 步骤 1：选择本地目录
  在你的计算机上选择一个空的文件夹，或者创建一个新的空文件夹，用于存放从仓库检出的文件。例如，创建一个名为 MyProject 的文件夹。

• 步骤 2：执行 Checkout 命令
  右键点击你选择的文件夹（例如 MyProject），在弹出的 TortoiseSVN 右键菜单中选择 SVN Checkout...。

• 步骤 3：填写 Checkout 信息
  在弹出的 Checkout 对话框中：

  • URL of repository: 填写你要检出的 SVN 仓库地址。这个地址通常由 SVN 服务器管理员提供，格式可能是 svn://服务器地址/仓库名/项目路径、http://服务器地址/svn/仓库名/项目路径 或 https://服务器地址/svn/仓库名/项目路径 等。
  • Checkout directory: 这一栏会自动填充为你右键点击的文件夹路径。确认它是你想要存放工作副本的位置。
  • Revision: 通常选择 HEAD revision，表示检出仓库中的最新版本。如果你需要检出历史版本，可以选择 Revision 并填写版本号。
  • 其他选项（如 Checkout depth）通常保持默认即可。

• 步骤 4：确认并等待检出
  点击“OK”。如果仓库需要认证，会弹出窗口要求你输入用户名和密码。输入正确的凭据后，点击“OK”。TortoiseSVN 会开始从仓库下载文件到你的本地目录。

• 步骤 5：检出完成
  检出过程会在一个进度窗口中显示。完成后，进度窗口会显示“Completed!”。点击“OK”或“Close”关闭窗口。现在，你的本地文件夹就是该 SVN 仓库的工作副本了。你会注意到文件夹和文件上出现了 TortoiseSVN 的图标覆盖。

3. 了解图标覆盖 (Icon Overlays)

检出完成后，你会看到你的工作副本中的文件和文件夹图标上覆盖着不同的小图标。这些图标非常重要，它们直观地告诉你文件当前的 SVN 状态：

• 绿色圆圈带白色对勾: Normal (正常/最新)。表示你的工作副本与仓库中的最新版本一致，且没有本地修改。
• 红色圆圈带白色感叹号: Modified (已修改)。表示你本地修改了文件，但还没有提交到仓库。
• 蓝色圆圈带白色加号: Added (已添加)。表示你添加了新文件或文件夹，并将其加入了版本控制，但还没有提交。
• 蓝色圆圈带白色减号: Deleted (已删除)。表示你删除了一个版本控制中的文件或文件夹，但还没有提交。
• 黄色圆圈带白色感叹号: Conflict (冲突)。表示你在更新时，你本地的修改与仓库中的修改发生了冲突，需要手动解决。
• 灰色圆圈带白色减号: Missing (丢失)。表示一个版本控制中的文件在你本地被删除，但没有通过 SVN 命令删除。
• 蓝色圆圈带白色问号: Unversioned (未版本化)。表示该文件或文件夹在你本地存在，但没有被加入版本控制。SVN 不会追踪它的变化。
• 灰色圆圈带白色斜杠: Ignored (已忽略)。表示该文件或文件夹已经被配置为忽略，SVN 不会将其添加到版本控制，也不会在未版本化文件中列出。

4. 基本工作流程：更新、修改、添加、删除、提交

这是日常使用 TortoiseSVN 最核心的部分。通常的工作流程是：先更新获取最新版本，然后进行修改，最后提交你的修改。

• a) 更新工作副本 (Update)
  在你开始工作之前，或者在你提交修改之前，强烈建议先进行“更新”操作。这会将仓库中其他人的最新修改同步到你的工作副本，避免你基于旧版本进行修改而导致冲突。

  • 右键点击你的工作副本文件夹（或其中的某个文件/文件夹）。
  • 选择 SVN Update。
  • TortoiseSVN 会连接仓库，下载并合并最新的修改。进度窗口会显示更新过程。如果发生冲突，会显示警告并用黄色冲突图标标记文件。

• b) 修改现有文件
  直接打开工作副本中的文件进行编辑和保存即可。TortoiseSVN 会自动检测到文件的修改，并将其图标变为红色“已修改”状态。

• c) 添加新文件/文件夹 (Add)
  如果你在工作副本中创建了新的文件或文件夹，它们最初是“未版本化”（Unversioned）状态（蓝色问号图标）。SVN 不会追踪它们，也不会在提交时包含它们。你需要显式地将它们添加到版本控制。

  • 右键点击新的文件或文件夹。
  • 选择 TortoiseSVN -> Add。
  • 选择要添加的文件/文件夹，点击“OK”。
  • 这些文件/文件夹的图标会变为蓝色“已添加”状态，表示它们已经被标记为要添加到仓库中，但尚未提交。

• d) 删除文件/文件夹 (Delete)
  不要直接在文件管理器中删除版本控制中的文件！这样会导致文件变为“丢失”状态。正确的做法是使用 SVN 的删除命令。

  • 右键点击要删除的文件或文件夹。
  • 选择 TortoiseSVN -> Delete。
  • 被删除的文件/文件夹会从你的工作副本中移除，并被标记为“已删除”状态（蓝色减号图标），等待提交。

• e) 重命名或移动文件/文件夹 (Rename/Move)
  同样，不要直接在文件管理器中重命名或移动文件。这会被 SVN 视为“删除旧文件”和“添加新文件”，会丢失文件的历史记录。

  • 右键点击要重命名或移动的文件或文件夹。
  • 选择 TortoiseSVN -> Rename... 或 TortoiseSVN -> Move versioned item to...。
  • 按照提示输入新的名称或目标位置。TortoiseSVN 会正确处理这些操作，保留文件的历史记录，并标记为相应的状态等待提交。

• f) 查看修改 (Check for Modifications / Diff)
  在提交之前，通常需要检查自己做了哪些修改。

  • 右键点击工作副本文件夹。
  • 选择 TortoiseSVN -> Check for Modifications。一个窗口会列出所有有修改、添加、删除、冲突等状态的文件。
  • 在这个列表中，右键点击一个“已修改”的文件，选择 Compare with base（与基准版本比较，即你上次更新或检出时的版本）或 Diff（通常与 base 相同，或与其他版本比较）。TortoiseSVN 的比较工具会打开，清晰地显示文件内容的差异。

• g) 提交修改 (Commit)
  当你完成了一组相关的修改，并且确认无误后，就需要将这些修改提交到仓库，使其他人也能看到并获取你的工作成果。

  • 右键点击你的工作副本文件夹（或包含你修改的特定子文件夹）。
  • 选择 SVN Commit...。
  • 会弹出一个 Commit 对话框。
    • Message: 这是非常重要的一步！ 在顶部的文本框中，你需要填写本次提交的日志信息。清晰、简洁、准确地描述你本次提交做了哪些修改、解决了什么问题、添加了什么功能等。良好的提交信息是团队协作和日后追溯历史的重要依据。
    • 文件列表: 下方会列出所有处于“已修改”、“已添加”、“已删除”状态的文件。默认情况下，所有这些文件都会被选中进行提交。你可以根据需要取消勾选某些文件，只提交部分修改（但请谨慎操作，确保提交的完整性）。
  • Show log / Diff: 在提交对话框中，你还可以点击按钮查看历史日志 (Show log) 或再次检查选定文件的修改 (Diff)。
  • 确认要提交的文件和提交信息无误后，点击“OK”。
  • TortoiseSVN 会连接仓库，上传你的修改。进度窗口会显示提交过程。提交成功后，文件的图标会变回绿色“正常”状态。

5. 处理冲突 (Resolving Conflicts)

冲突发生在多人修改了同一个文件的同一部分，并且这些修改无法自动合并时。TortoiseSVN 会用黄色感叹号图标标记冲突文件。

• 步骤 1：识别冲突
  在更新时，进度窗口会提示冲突发生。工作副本中的冲突文件会显示黄色感叹号图标。打开冲突文件，你会看到文件中包含了类似 <<<<<<<、=======、>>>>>>> 这样的标记，它们分隔了不同来源的修改。

• 步骤 2：解决冲突

  • 右键点击冲突文件。
  • 选择 TortoiseSVN -> Edit Conflicts。TortoiseSVN 的冲突编辑器会打开，帮助你查看并合并不同版本的修改。你也可以选择使用外部的合并工具。
  • 手动编辑文件，删除 SVN 添加的冲突标记 (<<<<<<< 等)，并保留你想要的内容（可能是你的修改、对方的修改，或者是两者的结合）。确保最终的文件内容是正确的、没有冲突标记的。

• 步骤 3：标记为已解决
  修改并保存冲突文件后，虽然文件内容已经合并，但 SVN 仍然认为它处于冲突状态。你需要告诉 SVN 冲突已经解决。

  • 右键点击解决冲突后的文件。
  • 选择 TortoiseSVN -> Resolved。
  • 文件的图标会变回红色“已修改”状态，表示冲突已解决，但文件仍然处于本地修改状态。

• 步骤 4：提交解决后的文件
  解决完所有冲突并标记为已解决后，你需要像提交普通修改一样，将这些文件的最终版本提交到仓库。右键点击工作副本 -> SVN Commit...，确保提交信息中说明你解决了冲突。

第三部分：其他常用操作

除了上述基本操作，TortoiseSVN 还提供了许多其他有用的功能：

• 查看日志 (Show Log): 右键点击文件或文件夹，选择 TortoiseSVN -> Show Log。你可以看到该文件/文件夹的所有历史提交记录，包括版本号、作者、日期、提交信息和修改的文件列表。你可以比较不同版本之间的差异，甚至回滚到某个历史版本。
• 比较差异 (Diff): 除了在 Check for Modifications 窗口中比较，你也可以右键点击任何版本控制中的文件，选择 TortoiseSVN -> Diff，然后选择一个版本进行比较。或者选择 Diff with previous revision 比较当前版本和前一个版本。
• 版本回退 (Revert): 如果你对本地的修改不满意，想要放弃它们，右键点击文件或文件夹，选择 TortoiseSVN -> Revert...。注意，这会撤销你自上次更新/检出或上次提交以来的所有本地修改！
• 创建分支/标签 (Branch/Tag): 用于创建代码的分支进行并行开发，或创建标签标记重要的发布版本。右键点击工作副本文件夹，选择 TortoiseSVN -> Branch/Tag...。你需要指定要创建分支/标签的源（通常是 HEAD 版本或特定版本）、目标 URL（仓库中的 /branches 或 /tags 目录下）以及名称。
• 切换分支 (Switch): 在不同的分支之间切换工作。右键点击工作副本文件夹，选择 TortoiseSVN -> Switch...，然后选择要切换到的分支的 URL。
• 清理 (Clean up): 当 SVN 操作被中断（例如电脑崩溃、进程被终止）时，工作副本可能会处于锁定状态。此时一些 SVN 操作可能无法执行。通过右键点击工作副本文件夹，选择 TortoiseSVN -> Clean up... 可以解锁工作副本。

总结

TortoiseSVN 凭借其与 Windows 文件管理器的深度集成和直观的图形界面，极大地降低了使用 SVN 进行版本控制的门槛。掌握了安装、检出、更新、修改、添加、删除、提交以及处理冲突这些基本操作，你就已经能够有效地进行个人项目管理和参与团队协作了。

版本控制是一个强大的工具，熟练使用它可以让你更自信地进行开发和管理文件。多加实践，逐步探索 TortoiseSVN 的其他功能，你将能更充分地发挥版本控制系统的优势。祝你使用愉快！

---