SVN 版本控制工具 TortoiseSVN 快速上手 – wiki基地

作者： /

TortoiseSVN 快速上手指南：版本控制，触手可及

在软件开发、文档写作、设计甚至是任何需要多人协作或需要追踪历史记录的领域，版本控制系统都是不可或缺的工具。它能帮助我们管理文件的变更，记录每一次修改，方便回溯到任何一个历史版本，解决协作时的冲突，甚至帮助我们管理项目的不同开发线路（分支）。

Subversion（SVN）是版本控制领域中一个成熟且广泛使用的集中式版本控制系统。而 TortoiseSVN 则是 Windows 平台上最流行、最易用、功能最强大的 SVN 客户端之一。它并非独立的应用程序，而是与 Windows 资源管理器（Explorer）深度集成，通过右键菜单和图标覆盖（Icon Overlays）的方式，让版本控制的操作就像文件操作一样直观便捷。

本文将带你详细了解 TortoiseSVN 的安装、核心概念以及最常用的日常操作，让你快速掌握这款强大的工具，告别手动备份文件版本的混乱日子。

第一章：认识 TortoiseSVN – 为什么选择它？

在开始学习使用 TortoiseSVN 之前，我们先来理解它的价值。

  1. 易用性极佳： TortoiseSVN 的最大特点是其与 Windows 资源管理器的无缝集成。你不需要打开一个独立的命令行窗口，也不需要学习复杂的命令。所有的操作都可以通过在文件或文件夹上点击右键来完成，就像复制粘贴文件一样简单。
  2. 直观的图形界面： 它提供了用户友好的图形界面来展示版本库的历史记录、文件差异、冲突解决等。通过可视化的方式，你可以清晰地看到文件发生了哪些变化，谁做了这些变化。
  3. 全面的功能： TortoiseSVN 支持 SVN 的所有核心功能，包括检出（Checkout）、更新（Update）、提交（Commit）、添加（Add）、删除（Delete）、移动（Move）、重命名（Rename）、分支（Branching）、标签（Tagging）、合并（Merging）、查看日志（Show Log）、比较差异（Diff）、解决冲突（Resolve Conflict）等等。
  4. 图标覆盖： 它通过在文件或文件夹图标上叠加小图标的方式，直观地显示其版本控制状态（例如，已修改、未提交、冲突、正常等），让你一眼就能了解工作副本的当前状态。
  5. 免费且开源： TortoiseSVN 是一款免费的开源软件，你可以自由地下载和使用它。

简而言之，TortoiseSVN 使得 SVN 这个强大的版本控制系统变得触手可及，即使是版本控制的新手也能快速上手。

第二章：安装 TortoiseSVN – 开始你的旅程

安装 TortoiseSVN 是使用它的第一步，过程非常简单。

  1. 下载安装程序：

    • 打开 TortoiseSVN 官方网站：https://tortoisesvn.net/downloads.html
    • 根据你的 Windows 操作系统版本（32位 或 64位）下载对应的最新稳定版安装程序。如果你不确定是 32 位还是 64 位，通常现在的新电脑都是 64 位。你可以在“此电脑”或“我的电脑”上右键点击“属性”查看系统类型。
    • TortoiseSVN 也提供语言包下载。如果你需要中文界面，可以在下载安装程序后，找到对应的语言包下载并安装。

  2. 运行安装程序：

    • 双击下载好的 .msi 安装文件。
    • 如果出现用户账户控制（UAC）提示，点击“是”允许程序运行。
    • 进入安装向导，点击“Next”。
    • 阅读并接受许可协议（License Agreement），点击“Next”。
    • 选择安装组件： 这一步很重要。默认选项通常包含大部分常用功能，建议保持默认。你可以根据需要选择是否安装命令行客户端（如果将来可能需要使用命令行操作 SVN）等。点击“Next”。
    • 选择安装位置： 可以选择默认的安装路径，或者点击“Change”选择其他位置。点击“Next”。
    • 点击“Install”开始安装。
    • 等待安装完成。

  3. 安装语言包（如果需要）：

    • 双击下载好的语言包 .msi 文件。
    • 按照提示完成安装。安装过程很简单，只需点击几下“Next”或“安装”。

  4. 完成安装并重启：

    • 安装完成后，向导会提示完成。通常建议勾选“Restart the computer now”或手动重启你的电脑，以确保 TortoiseSVN 的图标覆盖和右键菜单功能能够正常加载和工作。
    • 点击“Finish”完成安装。

电脑重启后，安装就完成了。你现在可以在 Windows 资源管理器中看到 TortoiseSVN 集成带来的变化。

第三章：SVN 核心概念速览 – 奠定基础

在使用 TortoiseSVN 进行具体操作之前，快速了解几个 SVN 的核心概念将有助于你更好地理解后续的操作。

  1. Repository (版本库/仓库)：

    • 这是版本控制系统的核心。它是一个中央存储库，保存了项目的所有文件和目录，以及所有历史版本的完整记录。
    • 版本库通常位于服务器上，可以通过 URL (Uniform Resource Locator) 访问，例如 svn://example.com/myproject 或 https://svn.example.com/myproject。
    • 版本库中的内容是唯一的“真相来源”。

  2. Working Copy (工作副本)：

    • 这是你在本地电脑上的项目文件和目录的副本。它对应于版本库中某个特定版本的内容。
    • 你在工作副本中进行开发、修改文件。
    • 工作副本与版本库中的内容是独立存在的，你在工作副本中的修改不会立即影响版本库。

  3. Revision (版本/修订版本)：

    • 每一次对版本库的成功提交（Commit）都会创建一个新的修订版本。
    • 每个修订版本都有一个唯一的、递增的整数编号（例如，r1, r2, r100）。
    • 一个修订版本代表了版本库中在某个特定时间点上的完整文件和目录快照。
    • 你可以随时回溯或查看任何一个历史修订版本的内容。

  4. Checkout (检出)：

    • 从版本库中获取一个指定版本（通常是最新版本）的项目文件到本地电脑，创建你的工作副本。
    • 这是你第一次获取项目代码时通常会执行的操作。

  5. Update (更新)：

    • 将工作副本与版本库中的最新版本进行同步。
    • 这个操作会将版本库中在你上次更新后发生的变更（其他人的提交）下载到你的工作副本中，确保你的本地代码是最新的。

  6. Commit (提交)：

    • 将你在本地工作副本中的修改（包括新增、修改、删除、移动等）上传到版本库中。
    • 每一次成功的提交都会创建一个新的修订版本。
    • 提交时需要提供一个提交信息（Commit Message），用于描述本次提交的内容和目的，这对于追踪历史记录非常重要。

  7. Add (添加)：

    • 通知 SVN 你想将工作副本中的一个新文件或目录纳入版本控制。
    • 文件被“添加”后，其状态会变为“待添加”，需要通过提交操作才能真正进入版本库。

  8. Delete (删除)：

    • 通知 SVN 你想从版本控制中移除一个文件或目录。
    • 文件被“删除”后，其状态会变为“待删除”，需要通过提交操作才能真正从版本库的最新版本中移除。

  9. Copy/Branch/Tag (复制/分支/标签)：

    • 在 SVN 中，分支（Branch）和标签（Tag）本质上都是版本库中特定路径的一个副本。
    • 分支通常用于并行开发，例如，从主开发线（trunk）创建一个分支来开发新功能，而不影响主线的稳定性。
    • 标签通常用于标记版本库中的一个稳定版本，例如，用于发布软件的某个版本。标签创建后通常不应再修改。

理解了这些概念，我们就可以开始实际操作了。

第四章：连接仓库与获取代码 – Checkout (检出)

当你加入一个已有的 SVN 项目时，第一步通常是获取项目的完整代码，也就是执行“检出”操作。

场景： 你需要从一个远程 SVN 服务器上的仓库中检出项目代码到你本地的指定文件夹。

操作步骤：

  1. 创建目标文件夹： 在你本地电脑上选择或创建一个空文件夹，用于存放检出后的项目代码。例如，D:\MyProjects\MySVNProject。
  2. 右键菜单： 在这个新建的空文件夹上点击鼠标右键。
  3. 选择 TortoiseSVN 菜单： 在弹出的右键菜单中，找到并选择“TortoiseSVN”子菜单。

  4. 选择 Checkout…： 在 TortoiseSVN 子菜单中，选择“Checkout…”选项。

  5. 填写 Checkout 对话框： 弹出一个“Checkout”对话框。

    • URL of repository: 在这个文本框中输入你要检出的 SVN 版本库的 URL。这个 URL 由你的项目管理员或团队提供，例如 https://svn.example.com/repos/myproject/trunk。这里的 trunk 通常代表项目的主开发线。
    • Checkout directory: 这个文本框会自动填充为你当前右键点击的文件夹路径（例如 D:\MyProjects\MySVNProject）。确保这个路径是正确的。
    • Revision: 可以选择检出哪个版本的代码。
      • 默认是“HEAD revision”，即最新版本，这是最常用的选项。
      • 你也可以点击右侧的按钮选择一个特定的历史版本或日期。
    • 其他选项（如Depth、Externals等）对于初学者来说通常保持默认即可。

  6. 点击 OK： 填写完必要信息后，点击对话框底部的“OK”按钮。

  7. 输入认证信息（如果需要）： 如果 SVN 版本库需要用户名和密码才能访问，会弹出一个认证对话框。输入你的 SVN 用户名和密码，并可以选择是否保存认证信息。点击“OK”。

  8. 等待检出完成： TortoiseSVN 会连接到 SVN 服务器，下载项目文件到你的本地文件夹。会弹出一个进度窗口显示正在进行的操作和进度。

    • 如果成功，进度窗口会显示所有文件已被下载，并提示成功。
    • 如果失败，会显示错误信息，例如网络问题、认证失败、URL 错误等。

  9. 查看结果： 检出完成后，关闭进度窗口。你会发现之前选择的空文件夹中已经填充了项目的文件和子文件夹。同时，这些文件和文件夹的图标上会出现绿色的勾，表示它们是 TortoiseSVN 工作副本的一部分，并且是最新（正常）状态。

恭喜你！你已经成功检出了 SVN 项目的工作副本。现在可以在本地进行开发和修改了。

第五章：日常工作流程 – 修改、提交、更新

一旦有了工作副本，你的日常工作就是在这个副本中进行修改，然后将修改提交回版本库，同时也要定期更新你的工作副本，获取其他人的最新变更。

这是一个循环过程：更新 -> 修改 -> 提交

5.1 修改文件与状态图标

在工作副本中，你可以像平时一样使用任何编辑器或工具修改文件、创建新文件、删除文件等。TortoiseSVN 会自动检测到这些变化，并在文件或文件夹图标上显示不同的图标覆盖来指示其状态：

  • 绿色圆圈带白色勾 (Normal): 文件或文件夹处于正常状态，与版本库的最新版本一致，没有本地修改。
  • 红色圆圈带白色感叹号 (Modified): 文件已被修改（内容发生了变化）。
  • 蓝色圆圈带白色加号 (Added): 新创建的文件或文件夹，已经被你添加到版本控制，但尚未提交。
  • 蓝色圆圈带白色减号 (Deleted): 文件或文件夹已被标记为删除，但尚未提交。
  • 黄色圆圈带白色感叹号 (Conflicted): 文件在更新过程中发生了冲突，需要手动解决。
  • 灰色圆圈带白色减号 (Missing): 文件应该存在于工作副本中，但已被你不通过 SVN 操作直接删除。
  • 深蓝色圆圈带白色问号 (Unversioned): 新创建的文件或文件夹，但尚未添加到版本控制中。
  • 灰色圆圈带白色斜线 (Ignored): 文件或文件夹被设置为忽略，SVN 不会对其进行版本控制。
  • 蓝色圆圈带白色锁 (Locked): 文件已被你锁定，以防止其他人修改（这是一种防止冲突的策略，但在现代开发中较少使用）。

这些图标非常直观，让你随时了解你本地代码的状态。

5.2 添加新文件或目录 (Add)

如果你在工作副本中新建了文件或目录，它们的图标会显示为问号（Unversioned）。这意味着 SVN 知道它们存在，但还没有将它们纳入版本控制。你需要手动将它们添加到 SVN 中。

操作步骤：

  1. 右键点击新文件/文件夹： 在你新创建的、显示问号图标的文件或文件夹上点击右键。

  2. 选择 TortoiseSVN -> Add： 在右键菜单中选择“TortoiseSVN”，然后选择“Add”选项。

  3. 确认添加： 弹出一个对话框，列出了即将被添加到版本控制的文件/文件夹。确认列表正确后，点击“OK”。

  4. 状态变化： 添加成功后，文件/文件夹的图标会变为蓝色加号（Added）。这表示它们已经被标记为“待添加”，等待下一次提交被纳入版本库。

5.3 删除文件或目录 (Delete)

如果你需要删除工作副本中的文件或目录，强烈建议使用 TortoiseSVN 的删除功能，而不是直接使用 Windows 的删除功能。使用 TortoiseSVN 删除会通知 SVN 你要删除这个文件，并且在提交时将删除操作记录到版本库中，同时也会保留文件的删除历史。

操作步骤：

  1. 右键点击要删除的文件/文件夹： 在你想要删除的文件或文件夹上点击右键。

  2. 选择 TortoiseSVN -> Delete： 在右键菜单中选择“TortoiseSVN”，然后选择“Delete”选项。

  3. 确认删除： 弹出一个确认删除的对话框。点击“OK”确认。

  4. 状态变化： 文件/文件夹会从文件系统中被移除，同时其图标会变为蓝色减号（Deleted），表示被标记为“待删除”，等待下一次提交从版本库中移除。

5.4 移动或重命名文件/目录 (Move/Rename)

与删除类似，移动或重命名文件或目录时也应该使用 TortoiseSVN 的功能。这样 SVN 会记录下文件的新位置或新名称，而不是认为你删除了旧文件又添加了新文件，从而保留文件的历史记录。

操作步骤：

  1. 右键点击要移动/重命名的文件/文件夹： 在你想要移动或重命名的文件或文件夹上点击右键。
  2. 选择 TortoiseSVN -> Rename… 或 Cut：
    • 如果是重命名，选择“TortoiseSVN”，然后选择“Rename…”。输入新名称后点击“OK”。
    • 如果是移动，选择“TortoiseSVN”，然后选择“Cut”。（是的，SVN 的移动操作通过“剪切”来实现）

  3. 粘贴到新位置 (仅移动)： 如果是移动操作，导航到目标文件夹，右键点击空白处，选择“TortoiseSVN”，然后选择“Paste”。

  4. 状态变化： 文件/文件夹会被移动到新位置或更改名称，并显示相应的状态图标（通常是修改状态或需要查看日志才能看到移动/重命名操作）。这些操作需要在下一次提交时同步到版本库。

5.5 提交你的修改 (Commit)

当你完成了一组相关的修改，并且希望将这些修改保存到版本库中，供其他团队成员获取时，就需要执行“提交”操作。

操作步骤：

  1. 右键点击工作副本的根目录或特定文件夹： 通常，你会在整个工作副本的根目录上执行提交操作，以便将所有已修改、已添加、已删除的文件一次性提交。你也可以在某个子文件夹上提交，只提交该文件夹及其子目录下的变更。

  2. 选择 TortoiseSVN -> Commit…： 在右键菜单中选择“TortoiseSVN”，然后选择“Commit…”选项。

  3. 填写 Commit 对话框： 弹出一个“Commit”对话框，这是提交的核心界面。

    • Message: 这是最重要的部分。你需要在这里输入提交信息（Commit Message）。提交信息是描述本次提交内容的文字说明，它应该简明扼要地说明你做了什么、为什么做以及相关的背景信息。 良好的提交信息对于日后回顾历史、理解变更非常重要。例如：“完成用户登录功能”、“修复首页布局问题”、“更新依赖库版本”。
    • 文件列表： 对话框的下方列出了你工作副本中所有发生变化的文件和文件夹（已修改、已添加、已删除等）。默认情况下，所有有变化的文件都被选中进行提交。
    • 选择要提交的文件： 仔细查看文件列表，确保你只想提交那些已经完成并准备好的修改。对于暂时不想提交的修改，取消勾选对应的文件。
    • 其他选项（如Keep locks、ChangeLists等）对于初学者可以暂时忽略。

  4. 点击 OK： 填写完提交信息并确认要提交的文件列表后，点击对话框底部的“OK”按钮。

  5. 输入认证信息（如果需要）： 如果需要认证，输入用户名和密码。

  6. 等待提交完成： TortoiseSVN 会将选中的修改上传到版本库。会弹出一个进度窗口。

    • 如果成功，进度窗口会显示提交完成，并提示新的修订版本号（例如 Committed revision rXXX.）。
    • 如果失败，会显示错误信息。常见的失败原因包括网络问题、认证失败、版本库只读、以及工作副本已过期（Out of date）。

5.6 更新工作副本 (Update)

在你提交之前或者开始工作之前，非常重要的一个步骤是更新你的工作副本。这是为了获取其他团队成员在你上次更新或检出后提交的最新修改。更新可以帮助你避免与他人的工作产生冲突。

操作步骤：

  1. 右键点击工作副本的根目录或特定文件夹： 通常在工作副本根目录执行更新，以获取所有最新变更。

  2. 选择 TortoiseSVN -> Update： 在右键菜单中选择“TortoiseSVN”，然后选择“Update”选项。

  3. 等待更新完成： TortoiseSVN 会连接到版本库，下载最新的变更，并将其应用到你的工作副本中。会弹出一个进度窗口。

    • 进度窗口会显示哪些文件被添加、删除或修改。
    • 如果成功，窗口会显示“Completed!”。
    • 如果在更新过程中，版本库中的修改与你本地的修改是针对同一个文件同一行的，就会发生冲突，进度窗口会提示有冲突，文件图标会变为黄色感叹号。

更新是一个高频操作，建议在开始工作前和提交前都执行一次更新。

第六章：查看历史与差异 – 了解发生了什么

版本控制的强大之处在于它记录了所有的历史。TortoiseSVN 提供了方便的工具来查看文件的历史记录和不同版本之间的差异。

6.1 查看日志 (Show Log)

查看日志可以帮助你了解版本库中文件或目录的所有提交历史：谁在什么时候提交了什么，提交信息是什么。

操作步骤：

  1. 右键点击文件或文件夹： 在你想要查看历史记录的文件或文件夹上点击右键。

  2. 选择 TortoiseSVN -> Show log： 在右键菜单中选择“TortoiseSVN”，然后选择“Show log”选项。

  3. Log Message 对话框： 弹出一个“Log Messages”对话框，显示了该文件或文件夹的所有提交历史记录。

    • 顶部列表： 列出了每一次提交（修订版本号、作者、日期、提交信息）。
    • 底部窗格： 当你选中顶部列表中的某次提交时，底部会显示该次提交影响到的文件列表。
    • 右键菜单（在日志列表上）： 在日志列表中的某个修订版本上右键点击，你可以选择：
      • “Show Changes”：查看该次提交修改了哪些文件。
      • “Compare with working copy”：比较该版本与你当前工作副本的差异。
      • “Compare with previous revision”：比较该版本与前一个版本的差异。
      • “Browse repository”：在版本库浏览器中查看该版本时的文件状态。
      • “Revert to this revision”：将工作副本恢复到该版本（慎用！会丢失该版本之后的所有本地修改）。
      • “Revert changes from this revision”：撤销该版本引入的变更（更常用，保留其他变更）。

查看日志是理解项目进展、定位问题、查看特定功能引入历史的重要手段。

6.2 查看文件差异 (Diff)

查看差异（Diff）是版本控制中最有用的功能之一。它可以可视化地展示两个版本之间文件的具体内容有哪些不同。

操作场景：
* 查看你当前工作副本对文件的修改与基准版本（你上次更新或检出的版本）之间的差异。
* 查看版本库中任意两个历史版本之间文件的差异。

操作步骤：

  1. 右键点击文件： 在你想要查看差异的文件上点击右键。
  2. 选择 TortoiseSVN -> Diff with previous revision 或 Diff:
    • Diff with previous revision: 比较该文件当前状态（如果是修改状态）或最新提交版本与它前一个版本之间的差异。
    • Diff: 这个选项更灵活。它通常会弹出一个子菜单，让你选择与什么进行比较，比如“Compare with working copy”、“Compare URLs”等。最常用的是比较工作副本与基准版本（Base）。如果文件是修改状态，直接双击文件图标，或者右键选择 TortoiseSVN -> Diff，通常会默认比较工作副本与基准版本。
  3. TortoiseMerge 工具： TortoiseSVN 会启动其内置的差异比较工具 TortoiseMerge。
    • TortoiseMerge 会以并排的方式显示两个文件版本的内容。
    • 不同之处会高亮显示，通常用颜色表示（例如，绿色表示新增的行，红色表示删除的行，蓝色表示修改的行）。
    • 你可以清楚地看到每一行代码具体的增删改。

熟悉使用 Diff 工具可以帮助你 review 自己的代码修改，理解他人的变更，以及解决冲突。

第七章：解决冲突 – 协作中的挑战

当你在工作副本中修改了一个文件，同时其他人在版本库中也修改了同一个文件同一行的代码并先于你提交时，你在执行“更新”操作时就会发生冲突。SVN 不知道应该保留谁的修改，所以会将文件标记为冲突状态（黄色感叹号图标），并暂停更新过程，需要你手动介入解决。

解决冲突的基本流程：

  1. 发生冲突： 执行 Update 操作后，某些文件图标变为黄色感叹号。进度窗口会提示冲突的文件。
  2. 编辑冲突文件： TortoiseSVN 会在冲突文件中插入特殊的标记，标识出不同版本的冲突块。你需要用文本编辑器或 TortoiseSVN 的冲突编辑工具打开这个文件。
    • 冲突标记示例：
      <<<<<<< .mine
      你的修改内容
      =======
      版本库中的修改内容
      >>>>>>> .rXXX
      <<<<<<< .mine 到 ======= 之间是你在本地工作副本中的修改。
      ======= 到 >>>>>>> .rXXX 之间是版本库中最新版本的修改（rXXX 是修订版本号）。
    • 你需要手动编辑这个文件，移除冲突标记，并决定最终应该保留哪些内容（可能是你的、他人的，或者是两者的结合）。
  3. 使用 TortoiseSVN 的冲突编辑工具： 右键点击冲突文件，选择 “TortoiseSVN” -> “Edit conflicts”。这会打开一个三窗口的工具，左边是你本地的修改，右边是版本库中的修改，中间是你正在编辑的最终文件。这个工具可以更方便地选择保留哪一部分内容。
  4. 标记为已解决： 手动编辑完冲突文件，并确保移除了所有冲突标记后，需要告诉 SVN 这个文件冲突已经解决了。右键点击冲突文件，选择 “TortoiseSVN” -> “Resolved”。
  5. 提交解决后的文件： 当所有冲突文件都被标记为已解决后，这些文件会变回修改状态（红色感叹号）。现在你可以像提交普通修改一样，将解决冲突后的文件提交到版本库中。这次提交包含了你解决冲突的结果。

解决冲突是协作开发中需要掌握的重要技能，虽然初次接触可能感觉复杂，但熟悉流程和工具后就会得心应手。

第八章：忽略文件与目录 – 让 SVN 更专注

在项目开发过程中，会产生一些不应该被纳入版本控制的文件或目录，例如：

  • 编译生成的中间文件或输出文件 (.obj, .exe, .dll)
  • 编辑器或 IDE 生成的临时文件或配置文件 (.suo, .user, .idea)
  • 日志文件 (.log)
  • 第三方库或依赖包 (node_modules, vendor)

这些文件通常不需要共享、会频繁变化或体积庞大，如果纳入版本控制会增加版本库的大小，干扰提交历史，甚至导致冲突。TortoiseSVN 允许你通过设置属性来忽略这些文件或目录。

操作步骤：

  1. 右键点击要忽略的文件或文件夹： 在你想要忽略的文件或文件夹上点击右键。这些文件通常显示问号图标（Unversioned）。
  2. 选择 TortoiseSVN -> Unversioned items as ignored： 在右键菜单中选择“TortoiseSVN”，然后将鼠标悬停在“Unversioned items as ignored”上。
  3. 选择忽略规则： 会弹出一个子菜单，列出了几种忽略方式：
    • Ignore item “文件名”： 仅忽略选中的这一个特定文件。
    • Ignore all “*.扩展名”： 忽略所在目录下及其子目录下所有与该文件具有相同扩展名的文件。
    • Ignore all “文件名”： 忽略所在目录下及其子目录下所有与该文件同名的文件。
    • Ignore folder “文件夹名”： 忽略选中的这个文件夹及其所有内容。
  4. 设置 svn:ignore 属性： 选择合适的忽略规则后，TortoiseSVN 会自动在其父目录上设置一个名为 svn:ignore 的 SVN 属性。这个属性的值就是忽略规则列表。
  5. 提交属性变更： 设置了 svn:ignore 属性的目录会显示为修改状态（红色感叹号，或者通过查看变更可以看到属性已修改）。你需要将这个属性变更提交到版本库中，以便团队其他成员也能享受到同样的忽略规则。提交该目录即可。

注意： svn:ignore 属性是设置在父目录上的，它的规则只应用于该父目录下的未版本控制文件和子目录。

第九章：分支与标签 (简介) – 管理项目流

分支（Branching）和标签（Tagging）是 SVN 中用于管理项目不同开发线和稳定版本的重要概念。在 SVN 中，分支和标签在版本库中实际上都是目录的副本。

  • 分支 (Branch): 通常用于隔离开发，例如从主开发线（trunk）创建一个功能分支来开发一个新功能，或者创建一个发布分支来准备即将发布的版本。在一个分支上的修改不会影响到其他分支，直到你通过合并（Merge）操作将变更同步。
  • 标签 (Tag): 通常用于标记版本库中某个时间点上的一个稳定、重要的版本，例如，标记一个发布的版本。标签创建后通常被视为只读的，不应该在其上进行修改和提交。

创建分支或标签的操作步骤：

  1. 右键点击要创建分支/标签的源文件/目录： 这通常是主开发线（trunk）或一个已有的分支。在 Windows 资源管理器中找到这个源目录，点击右键。

  2. 选择 TortoiseSVN -> Branch/Tag…： 在右键菜单中选择“TortoiseSVN”，然后选择“Branch/Tag…”选项。

  3. 填写 Branch/Tag 对话框：

    • Copy from URL: 这个文本框会自动填充你右键点击的源的 URL。确认这是你想要复制的源。
    • Working Copy: 也可以选择从本地工作副本创建分支/标签。但通常建议从版本库 URL 创建，这样可以确保是基于版本库的最新版本（或指定版本）进行复制，避免包含本地未提交的修改。
    • Copy to URL: 这是最关键的部分。 你需要在这里输入新分支或标签在版本库中的目标 URL。通常，SVN 版本库约定有 /trunk（主开发线）、/branches（存放分支）、/tags（存放标签）这三个顶级目录。所以你的目标 URL 可能是 https://svn.example.com/repos/myproject/branches/feature_xyz (创建分支) 或 https://svn.example.com/repos/myproject/tags/v1.0.0 (创建标签)。你需要手动创建或确认这些目标目录在版本库中存在。
    • Revision for new branch/tag: 选择基于源的哪个版本进行复制。默认是 HEAD revision（最新版本），你也可以选择特定的历史版本。
    • Log Message: 输入本次分支/标签创建的提交信息，说明创建的目的（例如，“Create branch for feature XYZ”或“Tagging release v1.0.0”）。

  4. 点击 OK： 填写完信息后，点击“OK”。

  5. 等待操作完成： TortoiseSVN 会向版本库提交一个复制操作。这会在版本库中创建一个新的目录，其内容是源在指定版本时的一个快照。这个操作很快，因为它不是物理复制文件，只是在版本库内部创建了一个指向。

创建分支和标签本身只是一个复制操作。后续在分支上进行开发，以及将分支的修改合并回主线（或另一个分支），则涉及更复杂的合并（Merge）操作，这属于 TortoiseSVN 的高级功能，在快速上手阶段可以先了解概念和创建方法即可。

第十章：其他常用功能快速浏览

除了上述核心操作，TortoiseSVN 还提供了许多其他实用的功能，可以让你更高效地使用 SVN。这里快速提及几个：

  • Revert (还原/撤销)： 撤销你本地工作副本中尚未提交的修改，将文件恢复到你上次更新时的状态。右键点击文件/文件夹 -> TortoiseSVN -> Revert…
  • Clean Up (清理)： 在工作副本因为某些错误（例如，上次操作中断）导致状态不一致时，执行清理操作可以恢复工作副本的正常状态。右键点击工作副本根目录 -> TortoiseSVN -> Clean Up…
  • Repository Browser (版本库浏览器)： 让你像浏览本地文件一样浏览远程 SVN 版本库中的内容，查看不同目录和版本的状态。右键点击任意文件夹或桌面空白处 -> TortoiseSVN -> Repo-browser。然后输入版本库 URL 即可浏览。
  • Export (导出)： 将版本库中指定版本的文件导出到一个新的文件夹，导出的文件不包含版本控制信息（即不是工作副本）。右键点击要导出的目录 -> TortoiseSVN -> Export… 选择目标路径和版本。

第十一章：常见问题与技巧

  • 图标不显示： 确保安装后重启了电脑。如果问题依然存在，可能是图标覆盖的处理程序数量达到了 Windows 的限制。可以尝试安装 64 位版本的 TortoiseSVN（如果系统是 64 位）或者检查是否有其他软件占用了太多图标覆盖槽位。TortoiseSVN 的设置中也有一个“Icon Overlays”页面可以查看和调整。
  • 提交失败提示“Out of date”： 这意味着你尝试提交的文件在你上次更新后，版本库中有了新的修改。你需要先执行 Update 操作，获取最新修改，解决可能出现的冲突，然后再进行提交。
  • 提交信息的重要性： 再次强调，认真编写清晰、准确的提交信息是好习惯，它极大地提高了版本历史的可读性和可维护性。
  • 定期更新： 养成频繁更新工作副本的好习惯，可以及时获取他人的工作进展，减少潜在的冲突。
  • 小步提交： 尽量将你的工作分成逻辑上独立的、较小的修改块进行提交。一个提交只做一件事情（例如，只实现一个功能、只修复一个 Bug）。这样即使需要回滚或查看历史，范围也更小，更容易管理。

总结

TortoiseSVN 是一个功能强大且用户友好的 SVN 客户端，它通过与 Windows 资源管理器的深度集成，极大地简化了版本控制的操作。通过本文的详细介绍，你应该已经掌握了 TortoiseSVN 的基本使用方法，包括：

  • 安装 TortoiseSVN
  • 理解 SVN 核心概念（版本库、工作副本、修订版本、提交、更新等）
  • 检出项目代码 (Checkout)
  • 日常工作流程：修改文件、添加、删除、移动/重命名、提交 (Commit)、更新 (Update)
  • 查看历史记录 (Show Log) 和文件差异 (Diff)
  • 解决冲突 (Resolve Conflict) 的基本流程
  • 忽略不需要版本控制的文件和目录 (svn:ignore)
  • 创建分支和标签 (Branch/Tag) 的基础

版本控制是一个实践出真知的东西。最重要的是现在就开始使用 TortoiseSVN，并在实际的项目中不断练习上述操作。随着你的使用经验增加，你会越来越感受到版本控制带来的便利和安全感。

祝你在版本控制的世界里旅途愉快！

发表评论

您的邮箱地址不会被公开。 必填项已用 * 标注

滚动至顶部