SVN入门教程：概念、安装与使用详解

2025-3-22

SVN 入门教程：概念、安装与使用详解

Subversion（简称 SVN）是一个开源的版本控制系统，用于管理和跟踪文件及目录随时间变化的修改。对于开发团队来说，版本控制是协作开发、代码管理和历史记录追溯的基石。本教程将深入浅出地介绍 SVN 的核心概念、安装过程以及常用操作，帮助初学者快速上手。

一、版本控制与 SVN 的核心概念

1.1 什么是版本控制？

版本控制系统（Version Control System，VCS）是一种记录一个或若干文件内容变化，以便将来查阅特定版本修订情况的系统。它可以帮助你：

追踪修改历史: 记录每次文件更改的详细信息，包括谁、何时、为何进行了更改。
回滚到旧版本: 轻松地将文件或整个项目恢复到以前的某个状态。
协同开发: 允许多个开发者同时在同一个项目上工作，合并彼此的更改。
分支与合并: 创建项目的独立开发分支，并在完成后将更改合并回主线。

1.2 为什么选择 SVN？

SVN 作为一款集中式版本控制系统，具有以下优点：

简单易学: SVN 的命令和概念相对简单，容易上手。
集中式管理: 所有版本信息都存储在中央服务器上，便于统一管理和备份。
权限控制: 可以对不同的用户和组设置不同的访问权限。
成熟稳定: SVN 经过多年的发展和广泛应用，已经非常成熟稳定。
图形化客户端: 有多种图形化客户端可用，例如TortoiseSVN。

当然，SVN 也有其局限性，例如：

单点故障: 如果中央服务器出现故障，所有人都无法提交或更新代码。
网络依赖: 必须连接到服务器才能进行大多数操作。

1.3 SVN 的核心概念

在深入学习 SVN 的使用之前，我们需要了解以下几个核心概念：

仓库（Repository）: SVN 仓库是存储所有项目文件和历史记录的中心位置。它通常位于服务器上，所有开发者都通过客户端连接到仓库进行操作。可以将仓库视为一个包含所有项目数据（包括所有历史版本）的数据库。
工作副本（Working Copy）: 工作副本是开发者从仓库检出的项目文件的本地副本。你可以在工作副本中进行修改、添加、删除文件等操作，然后将这些更改提交回仓库。每个开发者都有自己的工作副本，独立于其他开发者。
检出（Checkout）: 检出是从仓库获取项目文件的初始操作。它会在你的本地计算机上创建一个工作副本，其中包含仓库中指定版本（通常是最新版本）的文件。
更新（Update）: 更新操作用于将仓库中的最新更改同步到你的工作副本。当其他开发者提交了更改到仓库后，你需要执行更新操作来获取这些更改。
提交（Commit）: 提交操作将你在工作副本中所做的更改上传到仓库。每次提交都会创建一个新的版本，并记录你的用户名、提交时间和修改说明。
版本号（Revision Number）: SVN 使用一个递增的整数来表示每个版本。每次提交都会增加版本号，你可以通过版本号来访问项目的任何历史版本。
分支（Branch）: 分支用于从主线（trunk）上创建一个独立的开发线。你可以在分支上进行实验性的开发或修复 bug，而不会影响主线的稳定性。
标签（Tag）: 标签用于标记项目中的某个特定版本，例如发布版本。标签通常是只读的，不允许修改。
合并（Merge）: 合并操作用于将一个分支上的更改应用到另一个分支或主线上。当你在分支上完成了开发工作后，可以通过合并将更改合并回主线。
冲突（Conflict）: 当两个或多个开发者同时修改了同一个文件的同一部分时，就会发生冲突。SVN 无法自动解决冲突，需要开发者手动解决。
主干（Trunk）: 通常用于存放项目的稳定版本或主要开发线路。
锁定（Lock）: 在某些情况下，你可能需要锁定文件以防止其他开发者同时修改。SVN 支持文件锁定，但这通常不推荐使用，因为它会阻碍并行开发。

二、SVN 的安装

SVN 的安装分为服务器端和客户端两部分。服务器端用于存储仓库，客户端用于连接仓库并进行操作。

2.1 服务器端安装（以 Linux 为例）

2.1.1 安装 Subversion

```bash

使用 apt-get (Debian/Ubuntu)

sudo apt-get update
sudo apt-get install subversion

使用 yum (CentOS/RHEL)

sudo yum install subversion
```

2.1.2 创建仓库

```bash

创建一个目录来存放仓库

sudo mkdir /var/svn

创建一个名为 myproject 的仓库

sudo svnadmin create /var/svn/myproject
```

2.1.3 配置访问权限（可选）

默认情况下，任何人都可以访问仓库。你可以通过修改仓库的配置文件来设置访问权限。

```bash

编辑仓库的配置文件

sudo nano /var/svn/myproject/conf/svnserve.conf

取消以下行的注释，并修改相应的值：

anon-access = read # 匿名用户只读

auth-access = write # 认证用户可写

password-db = passwd # 密码文件路径

authz-db = authz # 权限控制文件路径

编辑密码文件

sudo nano /var/svn/myproject/conf/passwd

添加用户和密码，例如：

[users]

harry = harryssecret

sally = sallyssecret

编辑权限控制文件(可选)

sudo nano /var/svn/myproject/conf/authz

```

2.1.4 启动 SVN 服务

bash sudo svnserve -d -r /var/svn
-d 参数表示以守护进程模式运行，-r 参数指定仓库的根目录。

2.2 客户端安装

2.2.1 Windows

在 Windows 上，推荐使用 TortoiseSVN，它是一个图形化的 SVN 客户端，与 Windows 资源管理器集成，非常方便易用。

下载 TortoiseSVN: 访问 TortoiseSVN 官网（https://tortoisesvn.net/downloads.html），下载适合你系统的安装包。
安装 TortoiseSVN: 双击安装包，按照提示进行安装。
重启资源管理器: 安装完成后，可能需要重启资源管理器才能看到 TortoiseSVN 的右键菜单。

2.2.2 macOS

在 macOS 上，可以使用命令行工具或图形化客户端。

命令行工具: macOS 通常自带 SVN 命令行工具，你可以在终端中直接使用 svn 命令。
图形化客户端: 推荐使用 SmartSVN 或 Cornerstone。

2.2.3 Linux

在 Linux 上，可以使用命令行工具或图形化客户端。

命令行工具: 大多数 Linux 发行版都自带 SVN 命令行工具，你可以通过包管理器安装。
图形化客户端: 推荐使用 RabbitVCS 或 KDESvn。

三、SVN 的使用详解

3.1 常用操作

3.1.1 检出（Checkout）

检出操作用于从仓库获取项目文件的初始副本。

```bash

命令行

svn checkout <仓库 URL> <本地目录>

例如：

svn checkout svn://yourserver/svn/myproject /path/to/your/workingcopy

如果需要用户名和密码

svn checkout --username yourusername --password yourpassword svn://yourserver/svn/myproject /path/to/your/workingcopy

TortoiseSVN

在本地创建一个空文件夹。
右键单击该文件夹，选择 "SVN Checkout..."。
在 "URL of repository" 中输入仓库 URL。
点击 "OK"。
```

3.1.2 更新（Update）

更新操作用于将仓库中的最新更改同步到你的工作副本。

```bash

命令行

svn update

TortoiseSVN

右键单击你的工作副本文件夹。
选择 "SVN Update"。
```

3.1.3 提交（Commit）

提交操作将你在工作副本中所做的更改上传到仓库。

```bash

命令行

svn commit -m "提交说明"

例如：

svn commit -m "修复了一个 bug"

TortoiseSVN

右键单击你的工作副本文件夹。
选择 "SVN Commit..."。
在 "Message" 中输入提交说明。
选择要提交的文件。
点击 "OK"。
```

3.1.4 添加文件（Add）

添加操作用于将新文件或目录添加到版本控制中。

```bash

命令行

svn add <文件名或目录名>

例如：

svn add newfile.txt
svn add newdirectory

TortoiseSVN

右键单击要添加的文件或目录。
选择 "TortoiseSVN" -> "Add"。
```

3.1.5 删除文件（Delete）

删除操作用于从版本控制中删除文件或目录。

```bash

命令行

svn delete <文件名或目录名>

例如：

svn delete oldfile.txt
svn delete olddirectory

TortoiseSVN

右键单击要删除的文件或目录。
选择 "TortoiseSVN" -> "Delete"。
`` 注意：删除操作只是将文件标记为删除，你需要执行commit` 操作才能将删除操作真正提交到仓库。

3.1.6 查看状态（Status）

查看状态操作用于查看工作副本中文件的状态。

```bash

命令行

svn status

TortoiseSVN

右键单击你的工作副本文件夹。
选择 "TortoiseSVN" -> "Check for Modifications"。
```

状态输出中常见的标记：

?: 文件未受版本控制。
A: 文件已添加到版本控制，但尚未提交。
M: 文件已修改。
D: 文件已删除。
C: 文件存在冲突。

3.1.7 查看日志（Log）

查看日志操作用于查看项目的历史提交记录。

```bash

命令行

svn log

TortoiseSVN

右键单击你的工作副本文件夹。
选择 "TortoiseSVN" -> "Show log"。
```

3.1.8 解决冲突

当两个或多个开发者同时修改了同一个文件的同一部分时，就会发生冲突。SVN 无法自动解决冲突，需要开发者手动解决。

更新（Update）: 当发生冲突时，首先执行更新操作。SVN 会将冲突的文件标记为冲突状态，并生成三个临时文件：
- .mine: 你的本地修改版本。
- .r<旧版本号>: 冲突发生前的旧版本。
- .r<新版本号>: 其他开发者提交的新版本。
手动解决: 打开冲突的文件，你会看到类似以下的冲突标记：

```
<<<<<<< .mine
你的修改
=======
其他开发者的修改

.r<新版本号>
```

你需要手动编辑文件，删除冲突标记，并决定保留哪些修改。
标记为已解决: 解决完冲突后，使用以下命令将文件标记为已解决：

bash svn resolve --accept working <文件名>
提交（Commit）: 最后，提交你的更改。

3.1.9 创建分支（Branch）

创建分支用于从主线（trunk）上创建一个独立的开发线。

```bash

命令行

svn copy <源 URL> <目标 URL> -m "创建分支"

例如：

svn copy svn://yourserver/svn/myproject/trunk svn://yourserver/svn/myproject/branches/mybranch -m "创建 mybranch 分支"

TortoiseSVN

右键单击你的工作副本文件夹。
选择 "TortoiseSVN" -> "Branch/tag..."。
在 "To path" 中输入分支的 URL。
在 "Create copy in the repository from" 中选择 "HEAD revision in the repository"。
点击 "OK"。
```

3.1.10 切换分支（Switch）

切换分支操作用于将你的工作副本切换到另一个分支。

```bash

命令行

svn switch <分支 URL>

例如：

svn switch svn://yourserver/svn/myproject/branches/mybranch

TortoiseSVN

右键单击你的工作副本文件夹。
选择 "TortoiseSVN" -> "Switch..."。
在 "To URL" 中输入分支的 URL。
点击 "OK"。
```

3.1.11 合并分支（Merge）

合并操作用于将一个分支上的更改应用到另一个分支或主线上。

```bash

命令行

svn merge <源 URL>

例如：

将 mybranch 分支合并到主线

svn checkout svn://yourserver/svn/myproject/trunk # 切换到主线
svn merge svn://yourserver/svn/myproject/branches/mybranch
svn commit -m "合并 mybranch 分支"

TortoiseSVN

切换到你要合并到的目标分支（例如主线）。
右键单击你的工作副本文件夹。
选择 "TortoiseSVN" -> "Merge..."。
选择 "Merge a range of revisions"。
在 "URL to merge from" 中输入源分支的 URL。
点击 "Next"，然后按照提示进行操作。
```

3.2 高级操作

忽略文件: 你可以使用 svn:ignore 属性来告诉 SVN 忽略某些文件或目录，例如编译生成的临时文件、IDE 的配置文件等。
外部引用: 你可以使用 svn:externals 属性来引用其他仓库中的文件或目录。
钩子脚本: 你可以在仓库中配置钩子脚本，以便在某些事件发生时自动执行某些操作，例如提交前检查代码风格、提交后发送邮件通知等。

四、总结

本教程详细介绍了 SVN 的核心概念、安装过程以及常用操作。通过学习本教程，你应该能够掌握 SVN 的基本使用，并将其应用于你的开发工作中。

SVN 作为一款成熟稳定的版本控制系统，仍然被广泛应用于许多项目中。掌握 SVN 的使用，将有助于你更好地进行团队协作、代码管理和历史记录追溯。

但是，如果你正在开始一个新项目，并且需要更高级的功能，例如分布式版本控制、更快的速度和更灵活的工作流程，那么你可能需要考虑使用 Git。 Git 现在是更流行的版本控制系统。无论选择哪种工具，理解版本控制的基本原则都是非常重要的。

作者：admin

链接：https://hostlocvps.com/2025/03/22/svn%e5%85%a5%e9%97%a8%e6%95%99%e7%a8%8b%ef%bc%9a%e6%a6%82%e5%bf%b5%e3%80%81%e5%ae%89%e8%a3%85%e4%b8%8e%e4%bd%bf%e7%94%a8%e8%af%a6%e8%a7%a3/

文章版权归作者所有，未经允许请勿转载。

THE END