TortoiseSVN 使用教程：快速上手指南 – wiki基地

TortoiseSVN 使用教程：快速上手指南 (详尽版)

在软件开发、文档管理以及任何需要团队协作和历史追溯的场景中，版本控制系统扮演着至关重要的角色。它就像一个时光机和协作中心，帮助我们记录每次修改，协调团队成员的工作，并在需要时回退到任何一个历史版本。Subversion (简称 SVN) 是一个广泛使用的集中式版本控制系统，而 TortoiseSVN 则是 Windows 平台上与之配套的一款免费、开源的客户端工具。它以其直观的图形界面和与 Windows Explorer（文件管理器）的深度集成而闻名，使得 SVN 的使用变得异常简单和便捷。

本教程将带你一步步深入了解和使用 TortoiseSVN，从安装到日常操作，让你能够快速掌握 SVN 的基本工作流程，顺利融入基于 SVN 的团队协作环境。

文章目录

第一章：初识版本控制与 TortoiseSVN
1.1 为什么需要版本控制？
1.2 什么是 Subversion (SVN)？
1.3 为什么选择 TortoiseSVN？

第二章：安装与初步设置
2.1 下载 TortoiseSVN
2.2 安装过程详解
2.3 安装中文语言包 (可选但推荐)
2.4 初步认识工作副本状态图标

第三章：获取代码：检出 (Checkout)
3.1 什么是检出？
3.2 执行检出操作的步骤
3.3 理解检出选项 (URL, 目标路径, 版本, 深度)

第四章：日常工作流程：修改、添加、删除与提交
4.1 修改现有文件
4.2 添加新文件到版本控制
4.3 删除版本控制中的文件
4.4 重命名或移动文件
4.5 理解文件状态图标的含义
4.6 提交你的更改 (Commit)
4.6.1 什么是提交？
4.6.2 执行提交操作
4.6.3 撰写提交日志信息 (Commit Message) 的重要性
4.6.4 选择要提交的文件
4.6.5 完成提交

第五章：同步代码：更新 (Update)
5.1 什么是更新？
5.2 执行更新操作
5.3 理解更新结果

第六章：处理冲突 (Conflicts)
6.1 什么是冲突以及为什么会发生？
6.2 解决冲突的基本流程
6.3 使用 TortoiseMerge 工具解决文本冲突
6.4 标记冲突已解决 (Resolved)

第七章：查看历史记录与文件差异
7.1 查看日志 (Show Log)
7.1.1 日志界面的组成部分
7.1.2 查看特定版本的修改内容
7.1.3 与历史版本进行比较
7.1.4 回退 (Revert) 更改
7.2 比较文件差异 (Diff)

第八章：仓库浏览与高级功能初探
8.1 仓库浏览器 (Repo-Browser)
8.1.1 打开仓库浏览器
8.1.2 仓库浏览器的功能
8.2 创建分支 (Branch) 与标签 (Tag) (概念介绍)
8.3 清理工作副本 (Cleanup)

第九章：常见问题与最佳实践
9.1 频繁提交的好处
9.2 编写有意义的提交日志
9.3 频繁更新以减少冲突
9.4 避免提交生成的文件或临时文件
9.5 如何处理大型二进制文件

结论：持续实践，提升效率

第一章：初识版本控制与 TortoiseSVN

1.1 为什么需要版本控制？

想象一下，你正在进行一个项目，可能是一个软件、一份文档、一个设计稿，或者任何需要多人协作或需要记录修改历史的内容。如果没有版本控制，你可能会面临以下问题：

混乱的文件命名： 你可能会创建诸如 报告_最终版.docx, 报告_最终版_修改v2.docx, 报告_最终版_老板审阅后.docx 等等一系列文件，最终连自己都不知道哪个才是最新的、哪个是权威版本。
难以协作： 多个人同时修改同一个文件时，如何合并彼此的修改？手动复制粘贴容易出错且效率低下。
无法追溯历史： 想看看两周前某个文件是什么样的？想知道是谁在什么时候修改了哪一行代码？没有版本控制，这几乎是不可能完成的任务。
丢失风险： 如果你的电脑硬盘损坏，你的项目文件可能就永远丢失了。
难以回退： 如果某个修改导致了严重的问题，如何快速撤销这个修改并回到之前的稳定状态？

版本控制系统就是为了解决这些问题而诞生的。它提供了一个集中的（或分布式的）仓库，用于存储项目的所有文件及其修改历史。

1.2 什么是 Subversion (SVN)？

Subversion (SVN) 是一种流行的集中式版本控制系统。它的核心思想是有一个中央服务器，保存着项目的“主”版本库（Repository）。所有开发者都从这个中央仓库获取代码（检出，Checkout），在本地进行修改，然后将修改提交（Commit）回仓库。仓库会记录每一次提交，包括谁在何时做了什么修改。

SVN 的优点包括：
* 概念相对简单，易于理解和上手。
* 功能稳定，被广泛应用于企业环境。
* 支持原子提交（Atomic Commits），即一次提交中的所有修改要么全部成功，要么全部失败，不会出现部分成功的情况。

1.3 为什么选择 TortoiseSVN？

虽然你可以通过命令行使用 SVN，但这对于习惯图形界面的用户来说不够友好。TortoiseSVN 是一个 SVN 客户端，它与 Windows Explorer 深度集成，将 SVN 的各种操作直接融入到文件和文件夹的右键菜单中。

选择 TortoiseSVN 的理由：
* 图形化界面： 所有操作都可以通过鼠标点击完成，无需记住复杂的命令行指令。
* Windows Explorer 集成： 在文件或文件夹上右键即可看到 SVN 相关的菜单项，非常方便。
* 直观的状态图标： 文件和文件夹上会出现小图标，直观地显示它们当前的版本控制状态（已修改、已提交、冲突等）。
* 强大的辅助工具： 内置了文件比较工具 (TortoiseMerge)、仓库浏览器 (Repo-Browser) 等，方便进行版本差异对比和仓库内容查看。
* 免费与开源： 可以免费使用，且社区活跃。

TortoiseSVN 是 Windows 用户使用 SVN 的首选工具，它极大地降低了版本控制的学习曲线和使用门槛。

第二章：安装与初步设置

开始使用 TortoiseSVN 的第一步是下载并安装它。

2.1 下载 TortoiseSVN

访问 TortoiseSVN 的官方网站：https://tortoisesvn.net/downloads.html。

在该页面，你会看到不同版本的下载链接，选择与你的 Windows 操作系统位数相匹配的版本（通常是 64 位）。下载 .msi 格式的安装程序。

如果你需要安装中文语言包，也请在同一个页面找到语言包（Language Packs）部分，下载对应的中文语言包 .msi 文件。

2.2 安装过程详解

找到下载好的 .msi 安装文件，双击运行。安装过程通常非常简单，按照向导提示操作即可：

欢迎界面： 点击 “Next”。
最终用户许可协议 (EULA)： 阅读并同意协议，勾选 “I accept the terms in the License Agreement”，然后点击 “Next”。
自定义安装 (Custom Setup)： 这一步允许你选择要安装的组件和安装路径。通常情况下，保持默认选择（Typical）即可，它会安装所有常用组件。如果你有特定需求，例如不安装命令行客户端，可以在这里调整。选择安装路径，通常保持默认即可。点击 “Next”。
准备安装： 点击 “Install”。
用户账户控制 (UAC)： 如果弹出 UAC 提示，请选择 “是” 或 “Yes” 允许安装。
安装过程： 等待安装完成。
完成安装： 安装完成后，向导会提示你完成。非常重要的一步： 安装完成后，TortoiseSVN 会提示你需要重启计算机才能使 Explorer 集成生效。请勾选 “Restart the computer now” 或记住稍后手动重启。点击 “Finish”。

请务必重启计算机，否则你将看不到文件和文件夹上的 SVN 状态图标以及右键菜单中的 TortoiseSVN 选项。

2.3 安装中文语言包 (可选但推荐)

如果你下载了中文语言包，重启计算机后，双击运行中文语言包的 .msi 文件。安装过程同样简单：

欢迎界面： 点击 “Next”。
安装路径： 通常会自动检测 TortoiseSVN 的安装路径，点击 “Next”。
准备安装： 点击 “Install”。
完成安装： 点击 “Finish”。

安装完语言包后，你需要设置 TortoiseSVN 使用中文界面。在任意文件夹空白处点击右键，选择 TortoiseSVN -> Settings。在弹出的设置窗口中，选择 General 页面。在右侧找到 Language 选项，在下拉菜单中选择 “简体中文 (中国)” 或 “繁体中文 (台灣)”，然后点击 “OK”。应用设置后，TortoiseSVN 的界面就会变成中文。

2.4 初步认识工作副本状态图标

安装并重启计算机后，你会注意到一些文件和文件夹上出现了绿色的小图标。这些图标是 TortoiseSVN 与 Windows Explorer 集成的最直观体现，它们表示文件或文件夹当前的 SVN 状态。

绿色对勾 (Normal): 表示该文件或文件夹与仓库中的最新版本完全一致，是“干净”的。
红色感叹号 (Modified): 表示该文件已被修改过，但尚未提交到仓库。这是最常见的状态。
蓝色加号 (Added): 表示该文件是新添加的，已经被纳入版本控制管理，但尚未提交。
蓝色减号 (Deleted): 表示该文件已被计划删除，但尚未提交。
蓝色圆形叹号 (Conflicted): 表示该文件在更新过程中发生了冲突，需要手动解决。
灰色对勾 (Read-only): 表示该文件是从仓库中获取的，但设置为了只读属性（在某些工作流程中可能会遇到）。
金色感叹号 (Locked): 表示该文件被你锁定，以防止其他人修改（在某些团队协作策略中使用）。
问号 (Unversioned): 表示该文件位于你的工作副本中，但尚未被纳入版本控制管理。
忽略图标 (Ignored): 表示该文件或文件夹已被配置为忽略，不会被 SVN 管理（通常用于编译生成的临时文件、日志文件等）。

这些图标帮助你快速了解当前工作副本的状态，哪些文件改动了，哪些是新文件等等。

第三章：获取代码：检出 (Checkout)

要开始在一个 SVN 项目上工作，你首先需要从中央仓库中获取一份项目文件的本地副本，这称为“检出”（Checkout）。

3.1 什么是检出？

检出操作是从 SVN 仓库的特定 URL 和特定版本（通常是最新版本）获取项目文件和文件夹，并在你的本地计算机上创建一个“工作副本”（Working Copy）。这个工作副本是你进行开发和修改的本地环境。工作副本中包含了 .svn 隐藏文件夹，TortoiseSVN 通过这些文件夹来跟踪文件状态、与仓库同步等。请注意，不要手动删除或修改 .svn 文件夹。

3.2 执行检出操作的步骤

在你希望存放项目文件的位置，创建一个新的空文件夹。例如，你可以在 D:\Projects\ 下创建一个名为 MySVNProject 的文件夹。
右键点击这个新建的空文件夹（或者在其内部的空白处）。
在弹出的右键菜单中，选择 SVN Checkout… (如果你安装了中文语言包，可能是 TortoiseSVN -> 检出…)。
会弹出一个“Checkout”对话框。
- URL of repository: 在这里输入 SVN 仓库的 URL 地址。这个地址通常由你的项目管理员提供，可能类似于 svn://your_server_address/repository_name/trunk 或 https://your_server_address/svn/repository_name/project_name/trunk。
- Checkout directory: 这个字段会自动填充为你右键点击的文件夹路径。确保这是你想要存放工作副本的位置。
- Revision: 通常情况下，你应该检出仓库的最新版本（HEAD revision），这是默认选项。如果你需要获取历史版本的代码，可以在这里选择特定版本。
- Checkout depth: 检出深度决定了要获取多少层子目录的内容。通常选择 “Full, recursive” (完全递归)，获取所有文件和子目录。其他选项适用于只需要部分子目录的情况。
- Other options: 其他选项通常保持默认即可。
确认信息无误后，点击 OK。
如果仓库需要认证（用户名和密码），会弹出一个认证窗口。输入你的 SVN 用户名和密码。你可以选择保存认证信息，下次就无需再次输入。
TortoiseSVN 会开始从仓库下载文件。一个进度窗口会显示下载的文件列表和状态。
下载完成后，进度窗口会显示成功信息。点击 “OK”。

现在，你指定的文件夹中就有了项目的最新代码，并且文件夹和文件上应该会显示绿色的 SVN 状态图标。这就表示你成功创建了一个工作副本。

3.3 理解检出选项 (URL, 目标路径, 版本, 深度)

URL of repository (仓库URL): 这是 SVN 仓库中你想要检出的具体位置。一个仓库可能包含多个项目，每个项目下可能有 trunk（主干）、branches（分支）、tags（标签）等目录。你需要指定到你需要的目录层级。
Checkout directory (检出目录): 这是你的本地文件系统上存放工作副本的路径。
Revision (版本): SVN 仓库中的每一次提交都会创建一个新的版本号（一个递增的整数）。HEAD 是仓库的最新版本。检出时，你可以选择获取 HEAD 版本，也可以获取任意历史版本。
Checkout depth (检出深度):
- Full, recursive (完全递归): 获取指定 URL 下的所有文件和子目录及其内容。这是最常用的选项。
- Immediate children, including folders (仅获取直系子项，含文件夹): 获取指定 URL 下的所有文件和紧邻的子目录，但不获取子目录中的内容。
- Immediate children, only folders (仅获取直系子文件夹): 只获取指定 URL 下紧邻的子目录，不获取文件和子目录中的内容。
- Immediate children, only files (仅获取直系子文件): 只获取指定 URL 下紧邻的文件，不获取子目录。
- Only this item (仅获取此项): 只获取指定 URL 指向的单个文件或空目录。
- Exclude folders (排除文件夹): 获取指定 URL 下的所有文件，但不获取任何子目录中的内容。
- 在初次检出时，通常选择 Full, recursive。

第四章：日常工作流程：修改、添加、删除与提交

一旦有了工作副本，你就可以开始对文件进行操作了。SVN 的日常工作流程主要包括：修改现有文件、添加新文件、删除文件，然后将这些更改提交到仓库。

4.1 修改现有文件

修改文件非常简单，就像编辑普通文件一样。使用任何你喜欢的编辑器打开工作副本中的文件，进行修改并保存。

当你保存修改后，你会注意到该文件的 SVN 状态图标会从绿色对勾变成红色感叹号。这表示 TortoiseSVN 检测到该文件与它从仓库检出时的版本不一致，已经被修改了。

4.2 添加新文件到版本控制

如果你在工作副本中创建了一个新的文件或文件夹，它最初的状态图标会显示为问号。这表示 TortoiseSVN 知道这个文件存在，但它尚未被纳入版本控制。

要将新文件添加到版本控制，使其成为仓库的一部分，你需要执行“添加”操作：

右键点击新的文件或文件夹。
在弹出的菜单中，选择 TortoiseSVN -> Add (或添加)。
TortoiseSVN 会弹出一个窗口，显示你选择要添加的文件/文件夹列表。确认无误后，点击 OK。
添加成功后，新文件或文件夹的状态图标会变为蓝色加号。这表示该项已经被计划添加到仓库，但尚未提交。

重要提示： “Add” 操作只是告诉 SVN 你打算将这个文件纳入管理，它并不会立即将文件上传到仓库。这个操作需要后续的“提交”来最终完成。

4.3 删除版本控制中的文件

如果你想从项目中删除一个文件或文件夹，并且希望这个删除操作也能被 SVN 记录下来：

右键点击要删除的文件或文件夹。
在弹出的菜单中，选择 TortoiseSVN -> Delete (或删除)。
TortoiseSVN 会提示你确认删除操作。确认后，文件会从你的本地文件系统中被移到系统的回收站（默认行为，可以在 TortoiseSVN 设置中更改），同时该项的状态图标会变为蓝色减号。这表示该项已经被计划删除，但尚未提交。

重要提示： 和 “Add” 类似，”Delete” 操作只是标记该项为待删除状态，它并不会立即从仓库中删除文件。这个操作需要后续的“提交”来最终完成。如果你直接使用 Windows 的删除功能删除了版本控制中的文件，它的状态会变成“Missing”（丢失），虽然也可以通过提交丢失来达到删除的目的，但推荐使用 TortoiseSVN 的 Delete 功能。

4.4 重命名或移动文件

重命名或移动版本控制中的文件/文件夹，最好使用 TortoiseSVN 的功能，而不是直接在 Windows Explorer 中进行拖放或重命名。这是因为 SVN 会跟踪文件的历史，直接在文件系统层面操作会导致 SVN 丢失文件的历史关联。

重命名： 右键点击文件/文件夹 -> TortoiseSVN -> Rename… (或 重命名…)。输入新的名称，点击 OK。该项的状态图标会变为红色感叹号（表示修改，SVN 内部知道这是重命名）。
移动： 右键点击要移动的文件/文件夹，选择 Cut (剪切)。然后到目标位置，右键点击空白处，选择 TortoiseSVN -> Paste (move here) (或 粘贴 (移动到此处))。原位置的项会标记为待删除，新位置的项会标记为待添加（SVN 内部会记录这是移动操作）。

这些操作也都需要后续的“提交”来最终生效。

4.5 理解文件状态图标的含义

再次强调，理解这些图标对于掌握你的工作副本状态至关重要：

绿色对勾: 与仓库最新版本一致 (Normal)
红色感叹号: 已修改 (Modified)
蓝色加号: 计划添加到仓库 (Added)
蓝色减号: 计划从仓库删除 (Deleted)
蓝色圆形叹号: 发生冲突 (Conflicted)
问号: 未纳入版本控制 (Unversioned)
忽略图标: 已配置为忽略 (Ignored)
其他图标: 如金色锁（锁定）、灰色对勾（只读）、圆形感叹号（树冲突，Tree Conflict）等，表示更特定的状态。

通过观察这些图标，你可以随时知道哪些文件是你修改过的，哪些是需要提交的，哪些是需要注意的。

4.6 提交你的更改 (Commit)

当你完成了一系列修改、添加或删除操作，并且希望将这些更改保存到中央仓库，供团队成员共享和记录历史时，就需要执行“提交”（Commit）操作。

4.6.1 什么是提交？

提交是将你的工作副本中的本地更改（包括文件内容修改、文件添加/删除/重命名等）传输到 SVN 中央仓库的过程。每一次成功的提交都会在仓库中创建一个新的版本号（Revision）。提交是一个原子操作，要么所有选中的更改都成功写入仓库，要么全部失败。

提交是你与仓库同步的主要方式之一，它将你的工作成果与团队成员分享。

4.6.2 执行提交操作

右键点击包含你修改的文件或文件夹（通常是你的工作副本根目录或包含所有修改的子目录）。
在弹出的菜单中，选择 SVN Commit… (或 TortoiseSVN -> 提交…)。
会弹出一个“Commit”对话框。

4.6.3 撰写提交日志信息 (Commit Message) 的重要性

在提交对话框的顶部有一个文本框，用于输入“日志信息”（Log Message），也称为提交消息。这是一个非常重要的步骤，请务必认真对待。

好的提交日志信息应该简洁、清晰地描述本次提交做了什么修改，解决什么问题，或者添加了什么功能。这有助于你自己和团队成员在将来回顾历史时，快速理解每个版本的变化内容。

好的日志信息示例：
- feat: 添加用户注册功能
- fix: 修复首页布局错乱问题
- refactor: 重构用户认证模块代码
- docs: 更新安装指南文档
- chore: 更新依赖库版本
- feat: 实现购物车商品增删功能，同时修复了计算总价的 bug
不好的日志信息示例：
- 修改
- update
- 一堆代码
- .
- 不知道改了啥

请养成每次提交都认真填写日志信息的习惯。

4.6.4 选择要提交的文件

在提交对话框的下方，会列出你的工作副本中所有发生更改（Modified, Added, Deleted, Renamed, Moved 等）的文件和文件夹。列表中的每一项前面都有一个复选框。

默认情况下，所有发生更改的文件都会被选中。
如果你只想提交其中的一部分更改，可以取消勾选不想提交的文件。
你可以右键点击列表中的文件，进行一些操作，例如：
- Compare with base (与基准版本比较): 查看该文件与你从仓库检出时（或上次更新时）版本的差异。
- Compare with working copy (与工作副本比较，通常用不上，除非你想和自己改了但没保存的版本比)
- Revert changes (还原更改): 撤销对该文件的所有本地修改，回到基准版本。请谨慎使用，这会丢失你的本地修改！

4.6.5 完成提交

仔细检查要提交的文件列表，确保包含了你本次想要提交的所有相关更改。
在日志信息文本框中输入清晰、有意义的提交日志。
点击 OK。
TortoiseSVN 会开始将你的更改上传到仓库。一个进度窗口会显示上传的文件和状态。
上传完成后，进度窗口会显示成功信息，并显示本次提交产生的新的版本号 (Revision)。点击 “OK”。

提交成功后，你提交的文件的状态图标会变回绿色对勾，表示它们现在与仓库的最新版本一致了。

第五章：同步代码：更新 (Update)

在团队协作环境中，其他成员也在不断地向仓库提交他们的修改。你的工作副本不会自动同步这些修改。为了获取团队成员的最新代码，你需要执行“更新”（Update）操作。

5.1 什么是更新？

更新是将 SVN 仓库中自你上次检出或更新以来发生的最新更改下载到你的工作副本的过程。这可以确保你的工作副本与仓库的最新状态保持同步。

频繁地更新是一个非常好的习惯，它可以帮助你及时获取团队成员的最新进展，并尽早发现并解决与他人修改可能产生的冲突，避免问题累积。

5.2 执行更新操作

右键点击你的工作副本文件夹（通常是根目录）。
在弹出的菜单中，选择 SVN Update (或 TortoiseSVN -> 更新)。
TortoiseSVN 会连接仓库，检查是否有新的修改。
如果仓库有更新，TortoiseSVN 会下载这些更改，并将它们合并到你的工作副本中。一个进度窗口会显示正在更新的文件列表。
更新完成后，进度窗口会显示更新结果。可能会显示：
- U (Updated): 文件已成功更新。
- A (Added): 仓库中新增的文件已添加到你的工作副本。
- D (Deleted): 仓库中已删除的文件已从你的工作副本移除。
- C (Conflicted): 文件更新时发生了冲突，需要手动解决（见下一章）。
- G (Merged): 你本地也修改了文件，仓库中也有修改，且 SVN 自动成功合并了这些修改。
- E (Existed): 本地文件与仓库中版本一致，但内容被重新发送。
- R (Replaced): 文件被替换（先删除后添加）。
- X (External): 处理外部定义。
- ~ (Obstructed): 发生阻塞。
- I (Ignored): 被忽略。
- ! (Missing): 本地文件丢失。
- ? (Confused): 未知状态。
- L (Locked): 文件被锁定。
- B (Blocked): 更新被阻塞。
- _ (None): 没有改变。
点击 “OK” 关闭进度窗口。

更新完成后，你的工作副本就包含了仓库的最新代码。如果更新过程中出现了 C (Conflicted) 状态的文件，你需要暂停当前的工作，优先解决冲突。

第六章：处理冲突 (Conflicts)

冲突是版本控制中比较常见但也需要新手认真对待的问题。它通常发生在多人同时修改同一个文件的同一部分时。

6.1 什么是冲突以及为什么会发生？

冲突发生在以下情况：
1. 你检出或更新了文件 A 的版本 1。
2. 你在本地修改了文件 A。
3. 在你的修改过程中，你的同事也修改了文件 A，并将修改提交到了仓库，文件 A 的版本变成了版本 2。
4. 当你执行 SVN Update 时，SVN 发现你本地的文件 A 和仓库中的文件 A (版本 2) 都基于同一个旧版本 (版本 1) 进行了修改，并且这些修改发生在文件的相同位置。SVN 不知道应该保留谁的修改，因此它会标记文件 A 为冲突状态 (C)。

6.2 解决冲突的基本流程

遇到冲突并不可怕，TortoiseSVN 提供了工具来帮助你解决。解决冲突的流程通常如下：

执行 SVN Update 后，发现有文件的状态图标变成了蓝色圆形叹号，并且更新结果显示 C。
找到冲突的文件，用文本编辑器打开它。你会看到文件中包含了特殊的标记，用来指示冲突的部分。这些标记通常是 <<<<<<<, =======, >>>>>>> 以及 . 等符号。
- <<<<<<< .mine 到 ======= 之间的内容是你本地的修改。
- ======= 到 >>>>>>> .r[版本号] 之间的内容是仓库中别人的修改。
- >>>>>>> .r[版本号] 指示了引入冲突的仓库版本号。
你需要手动编辑这个文件，决定最终应该保留哪些内容。这可能意味着保留你的修改、保留别人的修改、或者将两者的修改进行合并，形成新的内容。同时，删除 SVN 添加的那些冲突标记符号。
保存修改后的文件。
告诉 SVN 这个文件上的冲突已经被你手动解决了。
提交解决冲突后的文件（和其他所有待提交的修改）。

6.3 使用 TortoiseMerge 工具解决文本冲突

手动编辑文件并删除标记容易出错。TortoiseSVN 提供了一个强大的文本比较和合并工具 TortoiseMerge 来帮助你可视化地解决冲突。

右键点击发生冲突的文件。
选择 TortoiseSVN -> Edit conflicts (或 TortoiseSVN -> 编辑冲突)。
TortoiseMerge 工具会打开，通常显示三个窗格：
- 左侧 (Yours): 显示你本地的修改（基于更新前的版本）。
- 右侧 (Theirs): 显示仓库中别人的修改。
- 底部或中间 (Merged): 显示合并后的结果。
TortoiseMerge 会高亮显示冲突的部分。你可以点击工具栏上的按钮或右键菜单，选择保留你的块、保留别人的块、或者手动编辑“Merged”窗格的内容来合并。
解决所有冲突后，保存并关闭 TortoiseMerge。

6.4 标记冲突已解决 (Resolved)

无论你使用手动编辑还是 TortoiseMerge，在文件内容修改正确后，你必须告诉 SVN 冲突已经解决。

右键点击已经解决冲突的文件。
选择 TortoiseSVN -> Resolved (或 TortoiseSVN -> 解决)。
该文件的状态图标会从蓝色圆形叹号变回红色感叹号，表示它现在只是一个普通的已修改文件了。

现在，你可以像提交普通修改一样，提交这个已解决冲突的文件和其他所有待提交的更改。提交已解决冲突的文件是非常重要的一步，它将你的解决结果上传到仓库，避免其他人再次遇到同样的冲突。

第七章：查看历史记录与文件差异

版本控制系统最重要的功能之一就是能够查看文件的修改历史以及不同版本之间的差异。

7.1 查看日志 (Show Log)

日志记录了仓库中每次提交的详细信息。通过查看日志，你可以了解项目的演变过程。

右键点击文件、文件夹或工作副本的根目录。
选择 TortoiseSVN -> Show Log (或 TortoiseSVN -> 显示日志)。
会弹出一个“Log Messages”窗口。

7.1.1 日志界面的组成部分

日志窗口通常包含：
* 顶部区域: 显示每个提交的概要信息，包括版本号 (Revision)、作者 (Author)、提交日期 (Date)、提交日志信息 (Message)。
* 中部区域: 当你选中顶部区域的某个提交时，这里会显示该提交具体修改了哪些文件。
* 底部区域: 显示选中文件的详细差异 (Diff)。

你可以使用工具栏上的按钮或右键菜单来筛选日志（按作者、日期、信息内容等），或者设置显示多少条日志记录。

7.1.2 查看特定版本的修改内容

在日志窗口的顶部区域，选中你感兴趣的某个历史版本。中部区域会显示该版本提交时修改的所有文件列表。

7.1.3 与历史版本进行比较

比较工作副本与历史版本： 在日志窗口中，右键点击某个历史版本，选择 Compare with working copy (与工作副本比较)。这会打开比较工具，显示你的本地修改与该历史版本之间的差异。
比较任意两个历史版本： 在日志窗口中，选中两个历史版本（按住 Ctrl 或 Shift 键选择）。右键点击，选择 Compare revisions (比较两个版本)。

7.1.4 回退 (Revert) 更改

如果你发现某个历史版本引入了问题，或者你想撤销之前提交的某些更改，可以使用“回退”功能。

回退到某个历史版本： 在日志窗口中，右键点击你想回退到的目标版本，选择 Update item to revision (将项目更新到此版本)。注意： 这个操作会用目标版本的状态覆盖你当前工作副本的内容。如果你有未提交的修改，请先提交或备份。
撤销某个提交引入的修改： 在日志窗口中，右键点击你想撤销的那个提交，选择 Revert changes from this revision (撤销此版本引入的更改)。TortoiseSVN 会计算出该提交的反向修改，并将其应用到你的工作副本中，标记为修改状态。你需要像提交普通修改一样，将这些反向修改提交到仓库，从而在仓库中产生一个新的版本，抵消掉之前版本的修改。

7.2 比较文件差异 (Diff)

除了在日志窗口中比较版本外，你还可以直接比较工作副本中的文件与仓库中的版本。

右键点击已修改的文件（状态图标为红色感叹号）。
选择 TortoiseSVN -> Diff with previous version (或 TortoiseSVN -> 与上个版本比较)。这里的“上个版本”通常是指你检出或上次更新时该文件的版本（即基准版本 BASE）。
TortoiseMerge 工具会打开，左侧显示基准版本，右侧显示你本地修改后的版本，高亮显示差异之处。

你也可以右键点击文件，选择 TortoiseSVN -> Diff (或比较)，然后选择要比较的两个文件（例如，你的工作副本文件和其他历史版本的文件）。

第八章：仓库浏览与高级功能初探

TortoiseSVN 还提供了一些更强大的功能，帮助你更好地管理和查看仓库。

8.1 仓库浏览器 (Repo-Browser)

仓库浏览器是一个独立的窗口，它让你能够像浏览本地文件系统一样，直接查看 SVN 仓库中的内容、文件状态、日志等信息，而无需检出整个仓库。

8.1.1 打开仓库浏览器

右键点击工作副本的任意位置或任何文件夹空白处，选择 TortoiseSVN -> Repo-Browser (或 TortoiseSVN -> 仓库浏览器)。如果你的工作副本是基于某个 URL 检出的，Repo-Browser 会自动打开该 URL。你也可以手动输入或修改要浏览的仓库 URL。

8.1.2 仓库浏览器的功能

查看目录结构： 像 Windows Explorer 一样，你可以在左侧的树状结构中导航仓库的目录。
查看文件列表： 在右侧窗格中，显示当前选中目录下的文件和子目录。
查看文件内容： 双击文件可以查看其内容（对于文本文件）。
查看历史日志： 右键点击文件或文件夹，选择 Show log (显示日志)，可以查看该项的提交历史。
获取文件或目录： 右键点击文件或文件夹，选择 Checkout (检出) 或 Export (导出)。导出只获取文件，不创建工作副本。
创建目录： 右键点击空白处或现有目录，选择 Create folder (创建文件夹)。
删除/重命名/移动： 可以在仓库中直接进行这些操作（需要有相应权限），这些操作会立即在仓库中产生一个新版本。
查看文件属性： SVN 允许给文件设置属性，可以在这里查看。
创建分支/标签： 可以在这里方便地从现有路径创建分支或标签。

仓库浏览器是了解仓库整体结构和内容的强大工具。

8.2 创建分支 (Branch) 与标签 (Tag) (概念介绍)

分支和标签是 SVN 中重要的概念，用于管理项目的不同开发线和重要里程碑。

分支 (Branch): 当你想在不影响主开发线（通常是 trunk）的情况下进行一项较大的新功能开发、Bug 修复或试验时，可以从主干创建一个分支。分支是主干的一个副本，你可以在分支上独立进行开发和提交，完成后再选择将分支合并回主干。
标签 (Tag): 标签通常用于标记项目历史中的一个重要、相对稳定的版本，例如发布版本 (Release)。标签是某个特定版本的一个只读快照（通常不应该在标签上进行修改）。通过标签，你可以随时方便地回到某个重要的历史状态。

在 TortoiseSVN 中创建分支或标签：

右键点击你希望创建分支/标签的源目录（通常是 trunk 或某个稳定的分支）。
选择 TortoiseSVN -> Branch/Tag… (或 TortoiseSVN -> 分支/标签…)。
在弹出的对话框中：
- Copy From: 源路径，通常是当前右键点击的路径。
- To URL: 目标 URL。你需要指定分支或标签将要创建的位置。通常在仓库的 branches 或 tags 目录下创建新的子目录，例如 .../branches/my_new_feature 或 .../tags/v1.0.0。
- Revision: 选择基于哪个版本创建分支/标签。通常基于 HEAD 版本创建分支，基于某个稳定的历史版本创建标签。
- 输入日志信息，描述创建分支/标签的目的。
点击 OK。

这个操作会直接在仓库中完成，它实际上是仓库内部的一个“复制”操作，通常非常快速，因为它只记录元数据，而不是物理复制所有文件。

分支和标签的进一步使用（如分支的合并）是更高级的主题，在本快速入门指南中不再详述。

8.3 清理工作副本 (Cleanup)

在某些情况下，你的工作副本可能会处于一个不一致的状态，例如上次操作（更新、提交等）中断了，或者状态图标显示不正常。这时，你可以尝试使用“清理”功能。

右键点击你的工作副本文件夹。
选择 TortoiseSVN -> Clean up… (或 TortoiseSVN -> 清理…)。
在弹出的对话框中，勾选你想要执行的清理任务。通常默认选项（如修复时间戳、清理锁定状态）就足够了。如果问题比较严重，可能需要勾选更彻底的选项，如 Remove unversioned files and folders (删除未纳入版本控制的文件和文件夹)，请谨慎勾选，以免误删文件！
点击 OK。

清理操作会尝试修复工作副本的内部状态，解除可能存在的锁定，使其恢复正常。

第九章：常见问题与最佳实践

掌握了 TortoiseSVN 的基本操作后，遵循一些最佳实践可以让你和团队更高效地使用 SVN。

9.1 频繁提交的好处

降低冲突风险： 你的修改越早提交到仓库，其他人越能及时获取你的最新代码，减少他们在你修改的同一区域进行修改的可能性，从而降低冲突发生的概率。
缩小冲突范围： 即使发生冲突，频繁提交意味着每次提交的修改量较小，冲突通常局限于小范围的代码，更容易解决。
细化历史记录： 每次提交都代表了一个逻辑上的工作单元完成，这使得历史记录更清晰，更容易回溯和理解项目的演变。

建议： 在完成一个小的、独立的任务或一个逻辑上的代码单元后，就进行一次提交。

9.2 编写有意义的提交日志

再次强调其重要性。好的日志信息是未来回顾历史、理解代码、查找问题时的重要线索。它应该清晰地说明本次提交的目的和内容。

9.3 频繁更新以减少冲突

在你开始工作之前、在你提交之前，都应该先进行一次 SVN Update。这可以让你获取团队成员的最新代码，避免在旧版本基础上进行修改，从而减少冲突，并确保你的代码是基于最新的基线开发的。

9.4 避免提交生成的文件或临时文件

项目中可能会产生一些由编译工具、编辑器或其他软件自动生成的文件（如编译生成的可执行文件、日志文件、IDE 配置文件等）。这些文件通常不属于项目的源代码或核心文档，而且它们的内容可能会频繁变化，如果提交到仓库会无谓地增加仓库体积和提交/更新的时间。

你应该将这些文件配置为 SVN 忽略。

右键点击你想要忽略的文件或文件夹。
选择 TortoiseSVN -> Unversion and add to ignore list (或 TortoiseSVN -> 取消版本控制并添加到忽略列表)。
你可以选择只忽略该项本身 (igonore "itemname")，还是忽略所有同名的项 (ignore all "itemname"s)，或者手动编辑忽略列表(Edit ignore list)。
选择后，该文件/文件夹的状态图标会变成忽略图标，SVN 将不再关注它的变化。

忽略列表通常是通过 svn:ignore 属性存储在父目录上的。忽略列表的配置也需要提交到仓库，以便团队成员共享同样的忽略规则。

9.5 如何处理大型二进制文件

SVN 在处理大型二进制文件（如图片、视频、编译产物等）时效率不高，因为它的版本控制是基于差异存储的。每次修改都会导致整个文件被上传，且仓库会存储文件的多个完整或接近完整的版本，导致仓库体积迅速膨胀。

如果你的项目大量包含这类文件，或者文件体积非常大，你可能需要考虑：
* 是否必须将它们纳入版本控制？ 有些生成的文件就不应该纳入。
* 考虑使用其他专门管理大文件的工具，结合 SVN 使用。
* 评估是否需要迁移到对大文件更友好的版本控制系统（如 Git LFS）。

对于本快速入门教程，记住尽量避免频繁修改并提交大型二进制文件即可。

结论：持续实践，提升效率

本教程详细介绍了使用 TortoiseSVN 进行 SVN 版本控制的基本操作，包括安装、检出、日常修改与提交、更新、冲突解决、查看历史以及一些常用高级功能。

版本控制是现代软件开发和团队协作中不可或缺的技能。通过 TortoiseSVN，你可以在 Windows 环境下以图形化的方式便捷地使用 SVN。

掌握这些基础知识只是第一步。最重要的是在实际项目中多加实践，熟练运用提交、更新、查看日志、解决冲突等操作。随着经验的积累，你会越来越体会到版本控制带来的便利和安全。

祝你使用 TortoiseSVN 愉快，并在团队协作中更加高效！

TortoiseSVN 使用教程：快速上手指南 (详尽版)

发表评论 取消回复

发表评论取消回复