Subversion (SVN) 入门教程：版本控制的基石

在软件开发、文档管理、网站建设等领域，团队协作和文件版本管理是不可或缺的一环。想象一下，如果没有一个有效的工具来记录文件的修改历史，协调多人的工作，那么项目文件的混乱、版本冲突、辛苦改动被意外覆盖等问题将层出不胜。这就是版本控制系统 (Version Control System, VCS) 诞生的原因。

Subversion（通常简称 SVN）是一种广泛使用的集中式版本控制系统。虽然近年来分布式版本控制系统（如 Git）变得更为流行，但 SVN 凭借其简单易用、功能稳定、管理集中等特点，在许多企业和项目中仍然扮演着重要的角色。

本教程将带你从零开始，详细了解 SVN 是什么，它如何工作，以及如何使用 SVN 完成日常的版本控制任务。我们将涵盖 SVN 的核心概念、安装、基本的命令行操作以及冲突解决等内容。

目标读者：
* 对版本控制完全陌生的初学者。
* 需要使用 SVN 进行项目协作的开发者、文档作者或任何需要管理文件版本的人。

阅读前提：
* 基本的计算机操作能力。
* 对命令行（终端）有基础认识（我们将以命令行操作为主进行讲解，因为它更通用）。

第一部分：理解版本控制和 SVN 的核心概念

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

简单来说，版本控制就是记录文件变化历史的系统。它可以让你：

追踪每一次修改： 知道文件在何时、由谁、做了哪些改动。
回溯到任意版本： 如果当前版本出现问题，可以轻松回到之前的稳定状态。
并行开发/协作： 允许多人同时修改项目的不同部分，并在之后合并这些修改。
备份和恢复： 所有的历史版本都存储在版本库中，相当于一个完整的项目备份。
解决冲突： 当多个人修改了同一个文件的同一部分时，版本控制系统能帮助你管理和解决这些冲突。

没有版本控制，你可能会发现自己通过复制文件并加上日期或描述来管理版本，比如 报告_v1.doc, 报告_v2.doc, 报告_最终版.doc, 报告_最终版_修改.doc… 这很快就会变得一团糟，且难以追踪具体的修改内容和协作情况。

2. SVN：一种集中式版本控制系统 (CVCS)

SVN 是一个典型的集中式版本控制系统。它的核心思想是：

一个中央版本库 (Repository)： 所有的文件和历史记录都存储在一个中心服务器上的版本库中。
客户端工作副本 (Working Copy)： 每个用户从版本库“签出”（Checkout）一份项目的最新版本到本地电脑上工作。
提交修改 (Commit)： 用户在本地完成修改后，将这些修改“提交”回中央版本库。
更新工作副本 (Update)： 用户定期从中央版本库“更新”他们的工作副本，以获取其他用户提交的最新修改。

(这是一个示意图链接，描绘了客户端与中心仓库的关系)

SVN 的优点：
* 易于理解和管理： 由于所有数据都在一个地方，管理相对简单。
* 权限管理： 可以对不同的用户或组设置细粒度的访问权限。
* 原子提交： 一次提交包含的所有修改要么全部成功，要么全部失败，不会出现部分提交的情况。

SVN 的缺点：
* 依赖中央服务器： 如果中央服务器崩溃或不可访问，用户将无法提交、更新或访问历史记录。
* 不适合离线工作： 大多数核心操作（提交、更新、查看完整历史）都需要连接到服务器。
* 分支合并相对复杂： 相比 Git，SVN 的分支和合并操作通常更繁琐一些。

3. SVN 的核心概念解释

理解以下概念是使用 SVN 的基础：

版本库 (Repository)： SVN 的核心，存储了项目所有的文件、目录结构以及完整的修改历史。它通常位于服务器上。
工作副本 (Working Copy)： 用户在本地电脑上从版本库签出（或更新）的项目文件的副本。你所有的修改都在工作副本中进行。
修订版本 (Revision)： 版本库中的每一个提交都会创建一个新的修订版本。修订版本是一个整数，从 1 开始递增。每一个修订版本都代表了整个版本库在某个时间点的一个快照。你可以随时访问或回溯到任何一个修订版本。
提交 (Commit)： 将你在工作副本中完成的修改（包括新增、修改、删除文件等）上传到版本库的操作。一个成功的提交会创建一个新的修订版本。
更新 (Update)： 从版本库下载其他用户提交的最新修改，同步到你的工作副本中。这是保持你的工作副本与版本库同步的重要操作。
签出 (Checkout)： 第一次从版本库获取项目文件到本地电脑，创建你的工作副本。
添加 (Add)： 告诉 SVN 你想将一个新文件或新目录添加到版本控制中。这个操作本身并不会立即影响版本库，而是在下次提交时生效。
删除 (Delete)： 告诉 SVN 你想删除一个被版本控制的文件或目录。同样，这个操作会在下次提交时生效。
状态 (Status)： 查看你的工作副本中文件的当前状态，比如哪些文件被修改了，哪些是新添加的，哪些被删除了，哪些是冲突的，哪些是未被版本控制的。
差异 (Diff)： 查看你的工作副本中的文件与版本库中最新版本之间的具体区别，或者查看任意两个修订版本之间的区别。
日志 (Log)： 查看文件或目录的修改历史，包括每个修订版本的作者、日期、提交信息以及修改内容摘要。
冲突 (Conflict)： 当你更新或合并时，如果本地修改与版本库中的修改发生在同一个文件的同一部分，SVN 无法自动合并，就会产生冲突。需要手动解决。

第二部分：安装 SVN 客户端

SVN 客户端允许你与 SVN 版本库进行交互。主要有两种类型的客户端：命令行客户端和图形界面 (GUI) 客户端。

1. 命令行客户端 (svn)

这是最基础也是最通用的客户端，适用于所有操作系统。

Windows:
- 推荐安装 SlikSVN (https://sliksvn.com/) 或 VisualSVN (https://www.visualsvn.com/downloads/) 的命令行客户端版本。下载安装程序，按照提示安装即可。安装时确保勾选将 SVN 命令行工具添加到系统的 PATH 环境变量，这样你就可以在任何地方的命令行中使用 svn 命令了。
macOS:
- 如果你安装了 Homebrew (macOS 包管理器)，打开终端运行：
  bash brew install subversion
- 如果没有 Homebrew，你可能需要安装 Xcode Command Line Tools (xcode-select --install)，它有时会包含 SVN，或者寻找其他第三方安装包。
Linux (Debian/Ubuntu):
- 打开终端运行：
  bash sudo apt update sudo apt install subversion
Linux (CentOS/RHEL):
- 打开终端运行：
  bash sudo yum install subversion

验证安装：
安装完成后，打开一个新的终端或命令提示符窗口，输入：
bash svn --version
如果看到 SVN 的版本信息，说明命令行客户端安装成功。

2. 图形界面 (GUI) 客户端

GUI 客户端通常提供更友好的用户界面，尤其是在 Windows 上，与文件管理器的集成非常方便。

Windows:
- TortoiseSVN (小乌龟): 这是 Windows 上最流行、集成度最高的 SVN 客户端。它作为 Windows Explorer 的扩展，在文件和文件夹上右键点击即可访问 SVN 功能。
  - 下载地址：https://tortoisesvn.net/downloads.html
  - 根据你的系统选择 32 位或 64 位版本下载安装。安装过程很简单，按照向导提示进行即可。安装完成后可能需要重启电脑。
macOS:
- Cornerstone (付费)
- SmartSVN (有免费版和付费版)
- SnailSVN (Finder 集成)
跨平台:
- SmartSVN (有免费版和付费版)
- Versions (macOS, 付费)
- 许多集成开发环境 (IDE)，如 Eclipse, NetBeans, IntelliJ IDEA, VS Code 等，都有内置的 SVN 插件。

本教程将主要使用命令行进行讲解，因为命令行操作更具通用性，并且能帮助你更好地理解 SVN 的底层工作原理。一旦掌握了命令行，使用 GUI 客户端也会非常容易。

第三部分：创建和访问 SVN 版本库

在开始版本控制之前，你需要一个版本库。对于初学者或进行本地测试，你可以在本地文件系统上创建一个版本库。对于团队协作，版本库通常会建在服务器上，并通过网络协议（如 svn:// 或 http://）访问。

1. 创建本地文件系统版本库

在你的电脑上选择一个位置来存放版本库。例如，在用户目录下创建一个 svn_repos 文件夹。

打开命令行终端，执行以下命令：
bash svnadmin create /path/to/your/svn_repos/my_project_repo
将 /path/to/your/svn_repos/my_project_repo 替换为你实际想创建版本库的路径。例如：
* Windows: svnadmin create C:\Users\YourUsername\svn_repos\my_project_repo
* macOS/Linux: svnadmin create ~/svn_repos/my_project_repo

执行成功后，SVN 会在该路径下创建一个包含 conf, db, hooks, locks 等子目录的标准版本库结构。

2. 版本库 URL

访问版本库需要使用 URL。

本地文件系统： file:///path/to/your/svn_repos/my_project_repo
- 注意，路径中 / 的使用方式（即使在 Windows 上）以及 file:// 后通常需要 3 个斜杠。
网络访问 (svn:// 或 http://): 如果版本库在服务器上，URL 看起来会像 svn://svn.example.com/my_project_repo 或 http://svn.example.com/my_project_repo。这需要服务器端配置 SVN 服务，超出了本入门教程的范围。我们后续的例子将主要使用 file:// URL。

第四部分：基本的 SVN 工作流程（命令行操作）

现在我们有了版本库，可以开始进行版本控制了。典型的 SVN 工作流程包括：签出、修改、更新、提交。

假设我们的本地版本库路径是 /path/to/your/svn_repos/my_project_repo，我们希望在本地电脑上的另一个目录 ~/my_project_working_copy 中进行开发。

1. 签出 (Checkout) – 获取工作副本

这是你第一次从版本库获取项目文件到本地。

bash svn checkout file:///path/to/your/svn_repos/my_project_repo /path/to/your/my_project_working_copy
或者使用前面例子中的简化路径：
bash svn checkout file:///path/to/your/svn_repos/my_project_repo ~/my_project_working_copy
执行后，SVN 会在指定的目标路径 (~/my_project_working_copy) 创建一个工作目录，并将版本库中的内容下载到这里。由于刚创建的版本库是空的，这个目录一开始也是空的，但它已经是受 SVN 控制的工作副本了。你会看到一个隐藏的 .svn 目录，这是 SVN 用来管理工作副本的元数据。

Checked out revision 0.
（刚创建的版本库修订版本是 0）

现在，进入你的工作副本目录：
bash cd ~/my_project_working_copy

2. 添加新文件/目录 (Add)

在你的工作副本中创建一些文件和目录。例如：

“`bash

创建一个 README 文件

echo “这是一个示例项目” > README.txt

创建一个 src 目录

mkdir src

在 src 目录中创建一个代码文件

echo “print(‘Hello, SVN!’)” > src/hello.py

创建一个 documentation 目录

mkdir documentation
echo “项目文档” > documentation/project_doc.md
“`

这些文件和目录现在在你的本地，但 SVN 还不认识它们（它们是“未版本控制”的文件）。使用 svn status 命令查看：

bash svn status
输出可能会是这样：
? README.txt ? src ? documentation
? 标记表示这些文件和目录是未版本控制的。

为了将它们纳入版本控制，你需要使用 svn add 命令：

bash svn add README.txt svn add src svn add documentation
注意：当你添加一个目录时，SVN 会递归地添加该目录下的所有文件和子目录。

再次运行 svn status：
bash svn status
输出现在变成了：
A README.txt A src A documentation
A 标记表示这些文件和目录已被安排添加到版本库中（处于“待添加”状态），等待下一次提交。

3. 修改文件 (Modify)

现在我们修改一个已经添加到版本控制中的文件（这里是 README.txt，尽管它还没有被提交，但在 SVN 看来它已经是待处理的“版本控制”文件了）。

bash echo "添加更多说明..." >> README.txt

运行 svn status 查看状态：
bash svn status
输出：
A src A documentation M README.txt
M 标记表示 README.txt 文件在工作副本中被修改了。

4. 查看修改内容 (Diff)

在提交之前，最好检查一下你到底修改了什么。使用 svn diff 命令：

bash svn diff README.txt
输出会显示文件修改的具体差异，通常使用 unified diff 格式：
diff --- README.txt (working copy) +++ README.txt (working copy) @@ -1 +1,2 @@ 这是一个示例项目 +添加更多说明...
- 开头的行表示被删除的内容，+ 开头的行表示新添加的内容。@@ ... @@ 部分表示差异所在的文件位置。

如果你想看所有被修改的文件的差异：
bash svn diff

5. 提交 (Commit) – 将修改保存到版本库

当你对修改满意后，就可以将这些变化提交到版本库了。提交是一个原子操作，所有待提交的修改要么都成功，要么都失败。

使用 svn commit 命令：

bash svn commit -m "Initial commit: Add README, src, and documentation directories."
-m 参数后面跟着的是提交信息 (Commit Message)。这是一个非常重要的部分，你应该写清楚本次提交做了哪些修改，为什么做这些修改。好的提交信息对于将来回顾历史非常有帮助。

执行提交命令后，SVN 会将你的修改上传到版本库：
Adding README.txt Adding src Adding src/hello.py Adding documentation Adding documentation/project_doc.md Transmitting file data ... Committed revision 1.
注意看最后一行，它告诉你提交成功，并且创建了一个新的修订版本 1。现在，这些文件和它们的历史记录就安全地保存在版本库中了。

再次运行 svn status：
bash svn status
应该没有任何输出，这表示你的工作副本与版本库的最新修订版本完全同步。

6. 更新 (Update) – 获取他人或最新的修改

在团队协作环境中，或者即使是你一个人在不同的地方工作，其他人的提交会导致版本库有新的修订版本。你需要定期运行 svn update 来获取这些最新的变化到你的工作副本。

假设现在版本库有了新的提交，修订版本变成了 2。你在你的工作副本中运行：

bash svn update
如果版本库有比你当前工作副本更新的修改，SVN 会下载并合并这些修改：
Updating '.': A new_file_added_by_others.txt U file_modified_by_others.txt Updated to revision 2.
* A 表示从版本库添加了一个新文件。
* U 表示版本库中的修改已经成功合并到你本地的文件中。
* Updated to revision 2. 表示你的工作副本现在同步到了版本库的修订版本 2。

重要提示： 在你开始修改文件之前，或者在你提交你的修改之前，强烈建议先运行 svn update。这可以让你及时获取最新的修改，并在提交前发现并解决潜在的冲突。

7. 删除文件/目录 (Delete)

要删除版本控制中的文件或目录，使用 svn delete 命令：

bash svn delete documentation/project_doc.md
运行 svn status：
bash svn status
输出：
D documentation/project_doc.md
D 标记表示该文件已被安排删除。

这个删除操作同样需要在下次 svn commit 时才会真正反映到版本库中。

bash svn commit -m "Remove project_doc.md as it's outdated."
Deleting documentation/project_doc.md Committed revision 2.
注意：执行删除操作后，工作副本中的文件确实被移除了。如果你想恢复，需要使用 svn revert 或从旧版本中签出。

8. 移动/重命名文件/目录 (Move/Rename)

SVN 提供了 svn move 或 svn rename 命令来移动或重命名受版本控制的文件或目录，同时保留其历史记录。

“`bash

重命名 README.txt 为 INTRODUCTION.md

svn rename README.txt INTRODUCTION.md
bash
svn status
输出：
R README.txt -> INTRODUCTION.md
``R` 标记表示这是一个重命名操作。

“`bash

移动 src/hello.py 到项目根目录

svn move src/hello.py .
bash
svn status
输出：
D src/hello.py
A hello.py
`` SVN 将移动视为一个删除 (D) 加一个添加 (A)，但如果你使用svn move` 命令，SVN 会在内部记录这是一个关联操作，历史记录会得到保留。

这些操作同样需要在 svn commit 后才反映到版本库。

9. 回退本地修改 (Revert)

如果在修改过程中发现搞砸了，或者不想提交当前对某个文件的修改，可以使用 svn revert 命令撤销本地的修改，回到最近一次 svn update 或 svn checkout 时的状态（即工作副本基础版本）。

“`bash

对 README.txt 进行了一些不想要的修改

…

svn status # 发现 README.txt 是 M 状态

撤销对 README.txt 的所有本地修改

svn revert README.txt

Reverted ‘README.txt’
`` 现在再次svn status，README.txt就不再显示M` 状态了。

如果你想撤销对某个目录下的所有修改（包括子目录），使用 -R 选项进行递归操作：
bash svn revert -R src/

注意： svn revert 只能撤销未提交的本地修改。一旦修改被 commit 到版本库，你就不能简单地 revert 了（需要使用其他方式，比如回到旧版本或删除本次提交，后者通常不推荐）。

10. 查看历史日志 (Log)

svn log 命令用于查看文件或目录的提交历史。

“`bash

查看整个版本库的提交历史

svn log

查看某个文件的提交历史

svn log INTRODUCTION.md

查看某个目录的提交历史

svn log src/

只看最近 5 条历史

svn log -l 5

查看某个修订版本范围内的历史

svn log -r 1:5 # 查看修订版本 1 到 5 的历史
svn log -r 5:1 # 查看修订版本 5 到 1 的历史（倒序）
输出通常包含修订版本号、作者、日期时间和提交信息：

r2 | your_username | 2023-10-27 10:00:00 +0800 (Fri, 27 Oct 2023) | 1 line

Remove project_doc.md as it’s outdated.

r1 | your_username | 2023-10-27 09:30:00 +0800 (Fri, 27 Oct 2023) | 1 line

Initial commit: Add README, src, and documentation directories.

“`

11. 查看旧版本文件内容

如果你想查看某个文件的旧版本内容，可以使用 svn cat 命令。

“`bash

查看 INTRODUCTION.md 在修订版本 1 时的内容

svn cat -r 1 INTRODUCTION.md
`` 输出会是修订版本 1 时README.txt(即现在的INTRODUCTION.md`) 的内容。

第五部分：处理冲突 (Conflict Resolution)

冲突是版本控制中一个常见的问题，特别是在多人同时修改同一个文件的同一部分时。SVN 无法自动决定保留哪个修改，因此会标记冲突，需要用户手动解决。

冲突发生的场景：
1. 用户 A 修改文件 X 的某部分并提交 (提交 A)。
2. 用户 B 也修改了文件 X 的相同部分。
3. 用户 B 尝试提交，但 SVN 发现版本库中的文件 X (已经包含提交 A 的修改) 比用户 B 工作副本中的文件 X 旧。SVN 要求用户 B 先 svn update。
4. 用户 B 运行 svn update。SVN 尝试将提交 A 的修改合并到用户 B 的工作副本。由于修改发生在文件的同一部分，SVN 无法自动合并，于是标记该文件为冲突 (C)。

解决冲突的步骤：

发生冲突： 当你运行 svn update 时，如果发生冲突，SVN 会输出类似这样的信息：
Updating '.': C src/hello.py Updated to revision 3. Summary of conflicts: Text conflicts: 1
C 标记表示 src/hello.py 文件发生了文本冲突。
检查冲突文件： 进入工作副本目录，查看发生冲突的文件。SVN 会在冲突文件中插入特殊的标记来指示冲突的部分。例如，src/hello.py 可能会变成这样：
“`python
print(‘Hello, SVN!’) # 这是你本地的修改

<<<<<<< .mine
print(‘这是我在本地新加的一行。’)
=======
print(‘这是别人在版本库中新加的一行。’)

.r3
`` *<<<<<<< .mine: 标记冲突开始，.mine到=======之间的内容是你本地的修改（基于你工作副本的**基础修订版本**）。 *=======: 分隔符。 *=======到>>>>>>> .r3: 之间的内容是版本库中最新版本（修订版本 3）的修改。 *>>>>>>> .r3: 标记冲突结束，.r3` 指示了来自版本库的哪个修订版本。

同时，在冲突文件旁边，SVN 还会生成几个临时文件，帮助你查看不同版本的内容（这些文件在你解决冲突并运行 svn resolved 后会被移除）：
* src/hello.py.mine: 冲突发生前，你的工作副本中该文件的内容。
* src/hello.py.rBASE: 冲突发生前，你的工作副本基于的那个版本的文件内容（你的修改是基于这个版本进行的）。
* src/hello.py.rNEW: 版本库中最新版本的文件内容（导致冲突的版本）。
手动编辑解决冲突： 打开冲突文件 (src/hello.py)，手动编辑内容，删除冲突标记 (<<<<<<<, =======, >>>>>>>)，并保留你想要最终版本包含的内容。你可以选择保留你自己的修改，保留别人的修改，或者将两者的修改进行合并。
例如，你决定保留两边的修改：
python print('Hello, SVN!') print('这是我在本地新加的一行。') print('这是别人在版本库中新加的一行。')
标记冲突已解决 (Resolved)： 手动编辑完文件并移除所有冲突标记后，需要告诉 SVN 这个文件已经解决了冲突。

bash svn resolved src/hello.py
这个命令会移除 .mine, .rBASE, .rNEW 文件，并告诉 SVN 这个文件不再处于冲突状态。
检查状态和提交： 再次运行 svn status。src/hello.py 应该显示为 M (Modified)，表示你对解决冲突后的文件进行了修改（这个修改现在包括了你和别人合并后的内容）。

“`bash
svn status

输出：

M src/hello.py

“`

现在可以像往常一样提交你的修改了。这个提交将包含解决冲突后的文件版本。

bash svn commit -m "Resolved conflict in src/hello.py and incorporated latest changes."

冲突解决是 SVN 使用中一个非常重要的环节，务必仔细处理，确保最终的文件内容是正确的。

第六部分：分支与合并 (Branching and Merging) – 入门了解

分支和合并是版本控制中处理并行开发的强大工具。虽然对于 SVN 初学者来说可能不是立刻需要掌握的，但了解它们的概念和基本用法很有帮助。

1. 标准版本库布局

SVN 社区推荐使用一个标准化的版本库布局，这有助于分支和合并操作：

/trunk (主开发线，通常是稳定或最新的代码) /branches (存放所有分支) /feature_x (例如：开发新功能 X 的分支) /bugfix_y (例如：修复 bug Y 的分支) /tags (存放所有标签，通常用于标记发布的版本，标签是不可修改的) /v1.0 /v1.1
trunk 是核心，branches 用于并行开发，tags 用于记录重要版本快照。

2. 创建分支 (Branching)

在 SVN 中，创建分支实际上是使用 svn copy 命令在版本库内部复制一个目录。这个复制是“廉价的”（cheap copy），SVN 内部并不会复制所有文件数据，而是通过引用来实现，所以速度很快，不占用太多空间。

假设你想从 trunk 创建一个名为 feature_branch 的分支：

“`bash

假设你的 trunk 在 file:///path/to/your/svn_repos/my_project_repo/trunk

并且你已经在版本库中创建了 /branches 目录

svn copy file:///path/to/your/svn_repos/my_project_repo/trunk \
file:///path/to/your/svn_repos/my_project_repo/branches/feature_branch \
-m “Create branch for feature development.”
`` 这个操作是直接在版本库进行的（服务器端操作），所以你不需要在本地有trunk` 的工作副本也能创建分支。

创建分支后，如果你想在这个分支上工作，需要 checkout 或 switch 到这个分支：

“`bash

如果你还没有工作副本

svn checkout file:///path/to/your/svn_repos/my_project_repo/branches/feature_branch ~/my_feature_working_copy

如果你已经在 trunk 工作副本中，想切换到分支

cd ~/my_project_working_copy # 确保在工作副本根目录
svn switch file:///path/to/your/svn_repos/my_project_repo/branches/feature_branch
``svn switch是一个非常有用的命令，它能快速将你的工作副本切换到同一个版本库中的另一个分支或标签，而无需重新checkout` 整个项目。

3. 合并 (Merging)

当你在分支上完成了开发，并希望将这些修改合并回 trunk（或另一个分支）时，就需要执行合并操作。SVN 的合并相对复杂一些，特别是手动合并冲突时。

基本合并流程（将分支合并到 Trunk）：

确保你的 trunk 工作副本是干净的（没有未提交的修改）。
进入 trunk 工作副本的根目录。
bash cd ~/my_project_working_copy # 确保这里是 trunk 的工作副本
更新 trunk 工作副本到最新版本，以避免不必要的冲突。
bash svn update
执行合并命令。告诉 SVN 你想将分支的哪些修改合并到当前工作副本（这里是 trunk）。通常是合并分支创建后在分支上的所有修改。

“`bash

将 feature_branch 的修改合并到当前（trunk）工作副本

svn merge file:///path/to/your/svn_repos/my_project_repo/branches/feature_branch .
``.` 表示将修改合并到当前目录（即工作副本根目录）。

SVN 会尝试自动合并修改。如果发生冲突，你需要手动解决（步骤同前面冲突解决部分）。
检查合并结果 (svn status, svn diff)。
提交合并结果到 trunk 版本库。
bash svn commit -m "Merge feature_branch into trunk."

合并是一个需要小心执行的操作。对于复杂的合并或频繁的合并需求，理解 SVN 的合并追踪（merge tracking）特性非常重要 (svn mergeinfo)，但这超出了本入门教程的范围。

4. 创建标签 (Tagging)

创建标签与创建分支类似，也是使用 svn copy，但标签通常是为了标记一个重要的、不可修改 的版本快照（如发布版本）。虽然 SVN 在技术上不禁止修改标签，但强烈不推荐这样做。

“`bash

从 trunk 创建一个 v1.0 版本标签

svn copy file:///path/to/your/svn_repos/my_project_repo/trunk \
file:///path/to/your/svn_repos/my_project_repo/tags/v1.0 \
-m “Tagging version 1.0 release.”
“`

或者从某个特定的修订版本创建标签（例如，从修订版本 5 创建标签）：

bash svn copy file:///path/to/your/svn_repos/my_project_repo/trunk@5 \ file:///path/to/your/svn_repos/my_project_repo/tags/v1.0_from_r5 \ -m "Tagging version 1.0 release from revision 5."
注意 URL 后面的 @5 语法，表示引用该 URL 在修订版本 5 时的状态。

第七部分：常用 SVN 命令速查与总结

这里列出一些最常用的 SVN 命令及其简要说明：

svn checkout URL [PATH]: 签出版本库或目录到本地工作副本。
svn update [PATH]: 更新工作副本，获取版本库最新修改。
svn status [PATH]: 查看工作副本的文件状态 (M, A, D, ?, C, !, etc.)。
svn add PATH: 安排文件或目录在下次提交时添加到版本控制。
svn delete PATH: 安排文件或目录在下次提交时从版本控制中删除。
svn copy SRC DEST -m "MESSAGE": 在版本库内部复制（用于分支和标签）。
svn move SRC DEST: 移动或重命名受版本控制的文件/目录。
svn commit -m "MESSAGE" [PATH]: 提交工作副本的修改到版本库。
svn diff [TARGET]: 查看修改内容的差异。
svn log [TARGET]: 查看提交历史。
svn cat TARGET[@REV]: 查看特定文件在特定修订版本的内容。
svn revert PATH: 撤销本地未提交的修改。
svn resolved PATH: 标记冲突已解决。
svn switch URL [PATH]: 将工作副本切换到版本库中的另一个 URL (分支/标签)。

第八部分：使用 TortoiseSVN (Windows GUI 客户端)

对于 Windows 用户，TortoiseSVN 提供了非常直观的图形界面。掌握了命令行概念后，使用 TortoiseSVN 会更简单。

安装 TortoiseSVN 后，它会集成到 Windows Explorer 的右键菜单中。

签出 (Checkout): 在你想创建工作副本的文件夹中，右键 -> SVN Checkout...。输入版本库 URL 和本地目录，点击 OK。
更新 (Update): 在工作副本文件夹或文件上右键 -> SVN Update。
提交 (Commit): 在工作副本文件夹或文件上右键 -> SVN Commit...。会弹出一个窗口显示所有修改的文件，你可以选择要提交的文件，输入提交信息，然后点击 OK。
添加 (Add): 在未版本控制的文件或文件夹上右键 -> TortoiseSVN -> Add。
删除 (Delete): 在受版本控制的文件或文件夹上右键 -> TortoiseSVN -> Delete。
状态和日志： 文件/文件夹图标上的叠加小图标会显示其状态 (M, + for added, ! for conflicted, etc.)。右键 -> TortoiseSVN -> Check for modifications 或 SVN Show log。
差异 (Diff): 在修改的文件上右键 -> TortoiseSVN -> Diff。可以比较工作副本与基础版本，或比较任意两个版本。
解决冲突： 冲突文件会显示红色感叹号图标。右键 -> TortoiseSVN -> Edit conflicts (使用内置的合并工具) 或手动编辑后右键 -> TortoiseSVN -> Resolved。

TortoiseSVN 的界面非常直观，多尝试点击右键菜单中的 SVN 相关选项，很快就能熟悉。

第九部分：总结与进阶

恭喜你！你已经完成了 SVN 入门的主要内容，掌握了 SVN 的核心概念和基本操作。现在你应该能够：

理解版本控制的重要性以及 SVN 的工作原理。
安装 SVN 客户端。
创建本地版本库。
签出、更新、添加、修改、删除和提交文件。
查看文件状态、差异和历史记录。
处理基本的文本冲突。
了解分支和标签的基本概念。

SVN 还有更多高级功能和议题，例如：

钩子脚本 (Hook Scripts): 在特定事件发生时（如提交前、提交后）自动执行脚本，用于强制提交规范、发送邮件通知等。
属性 (Properties): SVN 允许为文件或目录设置版本控制的属性，如 svn:ignore (忽略某些文件/目录，使其不显示为 ?)，svn:keywords (自动展开关键字，如作者、修订版本号)。
服务器端配置： 设置 svnserve 或 Apache + mod_dav_svn 提供网络访问、配置用户认证和权限。
更复杂的合并场景： 包含回溯合并、多分支合并等。

如果你需要进一步深入学习，可以查阅 SVN 的官方文档《Version Control with Subversion》（通常被称为 SVNBook，提供多种语言版本，包括中文版，并且可以在线免费阅读）。

版本控制是现代软件开发和团队协作的基础技能，熟练掌握它将极大地提高你的工作效率和项目管理能力。从现在开始，尝试在你的个人项目或团队项目中使用 SVN 吧！实践是最好的学习方式。

祝你在 SVN 的世界里探索顺利！

Subversion (SVN) 入门教程：版本控制的基石

第一部分：理解版本控制和 SVN 的核心概念

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

2. SVN：一种集中式版本控制系统 (CVCS)

3. SVN 的核心概念解释

第二部分：安装 SVN 客户端

1. 命令行客户端 (svn)

2. 图形界面 (GUI) 客户端

第三部分：创建和访问 SVN 版本库

1. 创建本地文件系统版本库

2. 版本库 URL

第四部分：基本的 SVN 工作流程（命令行操作）

1. 签出 (Checkout) – 获取工作副本

2. 添加新文件/目录 (Add)

创建一个 README 文件

创建一个 src 目录

在 src 目录中创建一个代码文件

创建一个 documentation 目录

3. 修改文件 (Modify)

4. 查看修改内容 (Diff)

5. 提交 (Commit) – 将修改保存到版本库

6. 更新 (Update) – 获取他人或最新的修改

7. 删除文件/目录 (Delete)

8. 移动/重命名文件/目录 (Move/Rename)

重命名 README.txt 为 INTRODUCTION.md

移动 src/hello.py 到项目根目录

9. 回退本地修改 (Revert)

对 README.txt 进行了一些不想要的修改

…

撤销对 README.txt 的所有本地修改

10. 查看历史日志 (Log)

查看整个版本库的提交历史

查看某个文件的提交历史

查看某个目录的提交历史

只看最近 5 条历史

查看某个修订版本范围内的历史

Remove project_doc.md as it’s outdated.

Initial commit: Add README, src, and documentation directories.

11. 查看旧版本文件内容

查看 INTRODUCTION.md 在修订版本 1 时的内容

第五部分：处理冲突 (Conflict Resolution)

输出：

M src/hello.py

第六部分：分支与合并 (Branching and Merging) – 入门了解

1. 标准版本库布局

2. 创建分支 (Branching)

假设你的 trunk 在 file:///path/to/your/svn_repos/my_project_repo/trunk

并且你已经在版本库中创建了 /branches 目录

如果你还没有工作副本

如果你已经在 trunk 工作副本中，想切换到分支

3. 合并 (Merging)

将 feature_branch 的修改合并到当前（trunk）工作副本

4. 创建标签 (Tagging)

从 trunk 创建一个 v1.0 版本标签

第七部分：常用 SVN 命令速查与总结

第八部分：使用 TortoiseSVN (Windows GUI 客户端)

第九部分：总结与进阶

发表评论 取消回复

发表评论取消回复