This is the article you requested:

SVN 使用教程：Subversion 的安装与基本操作

引言

在软件开发和项目管理中，版本控制系统扮演着至关重要的角色。它能够跟踪文件和目录随时间的变化，允许多人协同工作，并能轻松回溯到项目的任何历史版本。Subversion（简称 SVN）是一个经典的集中式版本控制系统，广泛应用于各种规模的项目中。

本教程旨在为初学者提供一个全面的 SVN 安装指南，并详细介绍其核心操作。无论您是需要搭建 SVN 服务器，还是仅仅作为客户端使用，本教程都将帮助您快速上手，掌握 SVN 的基本使用方法。

一、SVN 安装

SVN 的安装方式因操作系统而异。通常，您可以选择安装 SVN 客户端以连接到现有的 SVN 服务器，或者安装包含服务器组件的完整版以托管自己的代码仓库。

1. Windows 系统安装

对于 Windows 用户，有以下两种常见安装方式：

方式一：使用 VisualSVN Server (推荐用于服务器端)

VisualSVN Server 是一个功能强大且易于使用的 SVN 服务器解决方案，它集成了 Apache 和 SVN，并提供了直观的管理界面。

1. 下载： 访问 VisualSVN Server 官方网站下载最新版本安装包。
2. 运行安装程序： 双击下载的 .msi 文件，启动安装向导。
3. 遵循提示： 接受许可协议，选择安装组件（通常客户端和服务器组件都应选中）。
4. 完成安装： 按照向导指示完成安装。安装完成后，VisualSVN Server 通常会自动配置 Apache 以便通过 HTTP 访问仓库。

方式二：安装命令行客户端 (例如：CollabNet Subversion 或 WANdisco Subversion)

如果您只需要 SVN 命令行客户端，可以选择安装独立的客户端程序。

1. 下载： 访问 CollabNet Subversion 或 WANdisco Subversion 的下载页面，获取适合您系统的安装包。
2. 运行安装程序： 执行下载的安装文件。
3. 选择组件： 确保选中 “Subversion Command-Line Client” 组件。
4. 安装目录： 选择您偏好的安装路径。
5. 添加到 PATH (推荐)： 强烈建议在安装过程中勾选将 SVN 二进制文件目录添加到系统 PATH 环境变量的选项，以便在任何命令行窗口中直接使用 svn 命令。
6. 验证安装： 打开命令提示符（cmd）或 PowerShell，输入 svn --version。如果看到 SVN 版本信息，则表示安装成功。

2. macOS 系统安装

在 macOS 上，使用 Homebrew 包管理器是安装 SVN 的最便捷方式。

1. 安装 Homebrew (如果尚未安装)： 打开终端 (Terminal.app)，运行以下命令：
   bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   按照提示完成 Homebrew 的安装。
2. 安装 Subversion： Homebrew 安装完成后，在终端中运行：
   bash
brew install subversion
3. 验证安装： 安装完成后，在终端输入 svn --version。如果显示 SVN 版本信息，则安装成功。

3. Linux 系统安装

Linux 系统的安装方式因发行版而异，以下是常见的 Ubuntu/Debian 和 CentOS/RHEL 系统的安装方法。

对于 Ubuntu/Debian 系统：

1. 更新包列表：
   bash
sudo apt update
2. 安装 Subversion 客户端：
   bash
sudo apt install subversion -y
   这将安装基本的 SVN 客户端。
3. 安装 SVN 服务器与 Apache (可选，用于通过 HTTP 托管仓库)：
   • 安装所需软件包：
     bash
sudo apt install libapache2-mod-svn subversion-tools -y
   • 启用 Apache 模块：
     bash
sudo a2enmod dav
sudo a2enmod dav_svn
sudo systemctl restart apache2
   • 之后您需要配置 Apache 并创建仓库。

对于 CentOS/RHEL 系统：

1. 更新系统：
   bash
sudo yum -y update # 适用于 CentOS/RHEL 7 及更早版本
sudo dnf -y update # 适用于 CentOS/RHEL 8 及更新版本
2. 安装 Subversion 客户端和 Apache 模块：
   bash
sudo yum install mod_dav_svn subversion -y # 适用于 CentOS/RHEL 7 及更早版本
sudo dnf install mod_dav_svn subversion -y # 适用于 CentOS/RHEL 8 及更新版本
   此命令将安装 SVN 客户端和用于服务仓库的 Apache 模块。
3. 配置 Apache (用于托管仓库)：
   • 通常您需要在 /etc/httpd/conf.d/ 目录下创建一个配置文件（例如 subversion.conf），并在其中定义您的 SVN 仓库。
   • 重启 Apache：
     bash
sudo systemctl restart httpd
   • 您可能还需要配置 SELinux 并使用 htpasswd 等工具创建用户认证文件。

4. 验证安装

无论您在哪种操作系统上安装 SVN，最后都应通过命令行验证安装是否成功：

bash
svn --version
如果命令成功执行并显示 SVN 版本信息，则表明 SVN 已正确安装。

二、SVN 基本操作

掌握 SVN 的基本操作是高效进行版本控制的关键。本节将详细介绍 SVN 客户端的常用命令。

1. 创建仓库 (Repository)

SVN 仓库是存储所有版本化文件的地方。通常由管理员创建。

“`bash

创建一个空的仓库

svnadmin create /path/to/my_repository
“`

这将在指定路径 /path/to/my_repository 创建一个 SVN 仓库。

2. 导入项目 (Import)

将一个未经版本控制的现有项目导入到 SVN 仓库中。

“`bash

示例：将本地的 my_project 目录导入到仓库的 trunk 目录下

svn import /path/to/my_project file:///path/to/my_repository/trunk -m “Initial import of my project”
``
-/path/to/my_project: 本地项目的路径。
-file:///path/to/my_repository/trunk: 仓库中目标路径的 URL。file://用于本地仓库，如果是远程仓库，URL 可能是svn://host/repo/trunk或http://host/repo/trunk。
--m “Initial import…”`: 提交信息，描述本次导入的内容。

3. 检出工作副本 (Checkout)

从 SVN 仓库中获取项目的完整副本到本地，这个本地副本被称为“工作副本”(Working Copy)。

“`bash

示例：从仓库检出 trunk 分支到本地目录 my_local_project

svn checkout file:///path/to/my_repository/trunk my_local_project

简写形式

svn co file:///path/to/my_repository/trunk my_local_project
``
-file:///path/to/my_repository/trunk: 仓库中您想要检出的路径 URL。
-my_local_project`: 本地保存工作副本的目录名。如果省略，则会使用仓库路径的最后一个目录名。

4. 添加文件/目录 (Add)

将新的文件或目录添加到工作副本中，使其受 SVN 版本控制。svn add 仅仅是标记这些文件/目录待添加，实际提交到仓库需要使用 svn commit。

“`bash

添加单个文件

svn add new_file.txt

添加整个目录及其内容

svn add new_directory
``
在执行svn add后，可以使用svn status` 查看文件状态。

5. 提交更改 (Commit)

将工作副本中的修改（包括新增、修改、删除等）提交到 SVN 仓库中。

“`bash

提交所有修改过的文件

svn commit -m “Your descriptive commit message here”

简写形式

svn ci -m “Your descriptive commit message here”
``
--m “…”`: 提交信息，详细描述本次提交所做的更改。一个好的提交信息对于项目历史追踪至关重要。

6. 更新工作副本 (Update)

获取 SVN 仓库中最新的版本，同步到您的工作副本。

“`bash
svn update

简写形式

svn up
“`
这个命令会下载自上次更新以来所有被其他人提交的更改，并合并到您的本地工作副本中。

7. 查看状态 (Status)

查看工作副本中文件的当前状态，了解哪些文件被修改、新增、删除或冲突。

“`bash
svn status

简写形式

svn st
``
输出示例：
-M: 文件已被修改 (Modified)
-A: 文件已被添加 (Added)
-D: 文件已被删除 (Deleted)
-?: 文件在工作副本中，但不受版本控制 (Not versioned)
-!: 文件丢失或不完整
-C`: 文件发生冲突 (Conflicted)

8. 查看差异 (Diff)

比较工作副本中的文件与仓库中的最新版本之间的差异。

“`bash

查看指定文件的差异

svn diff my_file.txt

查看整个工作副本的差异

svn diff
“`

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

从版本控制中删除文件或目录。与 svn add 类似，这只是标记待删除，需要 svn commit 才能实际从仓库中移除。

“`bash

删除文件

svn delete old_file.txt

简写形式

svn del old_file.txt

删除目录

svn delete old_directory
“`

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

在版本控制下移动或重命名文件/目录。

“`bash

重命名文件

svn move old_name.txt new_name.txt

简写形式

svn mv old_name.txt new_name.txt

移动文件到另一个目录

svn mv file.txt new_directory/file.txt
``
执行这些操作后，也需要svn commit` 来将更改提交到仓库。

11. 恢复更改 (Revert)

撤销对工作副本中文件的本地修改，将其恢复到最近一次更新或提交时的状态。

“`bash

恢复单个文件到上次更新/提交的状态

svn revert my_modified_file.txt

恢复整个目录下的所有修改

svn revert -R my_directory/
``svn revert` 是一个本地操作，不会影响仓库。

12. 查看日志 (Log)

查看文件的历史记录，包括每次提交的作者、日期、提交信息和版本号。

“`bash

查看指定文件的日志

svn log my_file.txt

查看整个目录的日志

svn log
``
您也可以使用-l N参数限制日志条目数量，例如svn log -l 5`。

结语

Subversion (SVN) 作为一个成熟且稳定的集中式版本控制系统，在项目管理和协同开发中发挥着重要作用。通过本教程，您应该已经掌握了 SVN 的安装方法，以及日常开发中最常用的基本操作。

虽然目前分布式版本控制系统（如 Git）越来越流行，但 SVN 凭借其简单易用、易于管理等特点，在许多企业和项目中仍占有一席之地。熟练运用 SVN，将能有效帮助您管理代码变更，提高团队协作效率，确保项目开发的顺利进行。希望本教程能为您的 SVN 之旅提供坚实的基础！