HoRain云--SVN安装全攻略

项目	说明
全称	Apache Subversion
类型	集中式版本控制系统
用途	代码版本管理、文件历史追踪、团队协同开发
官网	https://subversion.apache.org/
特点	免费开源、支持多平台、图形化客户端丰富

🪟 二、Windows 系统安装

方式一：TortoiseSVN 客户端（推荐 ⭐）

TortoiseSVN（俗称"小乌龟"）是 Windows 下最流行的 SVN 客户端，集成到资源管理器右键菜单。

📥 下载地址：https://tortoisesvn.net/downloads.html

安装步骤：

下载安装包
- 访问官网下载最新版本的 TortoiseSVN
- 选择与系统匹配的位数（64位/32位）

运行安装程序

双击安装包 → 选择安装语言 → 接受协议 → 选择安装组件

选择安装组件
- ✅ TortoiseSVN（必选）
- ✅ Command line client tools（命令行工具，建议勾选）
- ✅ 语言包（可选中文）
完成安装
- 安装完成后重启电脑
- 右键菜单出现 SVN 相关选项即表示安装成功

汉化设置（可选）

TortoiseSVN → Settings → General → Language → 选择 Chinese (Simplified)

验证安装：

# 打开命令提示符
svn --version
# 显示版本号即表示安装成功

方式二：VisualSVN Server（服务器端）

适合在 Windows 上搭建 SVN 服务器。

📥 下载地址：https://www.visualsvn.com/server/download/

安装步骤：

下载 VisualSVN Server 安装包
运行安装程序，选择安装路径
配置 SVN 根目录（默认 C:\Repositories）
设置访问端口（默认 443）
选择认证方式（Windows 认证或 Subversion 认证）
完成安装并启动服务

管理界面：

打开 VisualSVN Server Manager
右键创建新的 Repository
配置用户和权限

方式三：命令行客户端

📥 下载地址：https://subversion.apache.org/packages.html#windows

安装步骤：

下载 Windows 二进制包（如 svn-1.14.x-win64.zip）
解压到指定目录（如 C:\Program Files\Subversion）

添加环境变量：

系统属性 → 高级 → 环境变量 → Path → 添加 SVN 安装目录\bin

验证：svn --version

🐧 三、Linux 系统安装

Ubuntu/Debian 系统

# 1. 更新软件包列表
sudo apt update

# 2. 安装 SVN 客户端
sudo apt install subversion -y

# 3. 安装 Apache2 支持（可选，用于 HTTP/HTTPS 访问）
sudo apt install libapache2-mod-svn -y

# 4. 验证安装
svn --version

CentOS/RHEL/Fedora 系统

# CentOS 7/8 或 RHEL
sudo yum install subversion -y

# 或 Fedora
sudo dnf install subversion -y

# 验证安装
svn --version

安装 SVN 服务器（Linux）

# 1. 安装 SVN
sudo apt install subversion -y

# 2. 创建版本库目录
sudo mkdir -p /svn/repos
sudo svnadmin create /svn/repos/myproject

# 3. 设置权限
sudo chown -R www-data:www-data /svn/repos
sudo chmod -R 755 /svn/repos

# 4. 配置 Apache（如需 HTTP 访问）
sudo apt install libapache2-mod-svn apache2 -y

# 5. 编辑 Apache 配置
sudo nano /etc/apache2/mods-available/dav_svn.conf

# 6. 重启 Apache
sudo systemctl restart apache2

🍎 四、macOS 系统安装

方式一：Homebrew（推荐）

# 1. 安装 Homebrew（如未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 2. 安装 SVN
brew install subversion

# 3. 验证安装
svn --version

方式二：MacPorts

# 安装 SVN
sudo port install subversion

# 验证
svn --version

方式三：官方安装包

📥 下载地址：https://subversion.apache.org/packages.html#os-x

下载 .dmg 文件，双击安装即可。

🔧 五、SVN 基本使用命令

# 1. 检出代码（Checkout）
svn checkout http://svn.example.com/repos/project myproject
svn co http://svn.example.com/repos/project myproject  # 简写

# 2. 更新代码（Update）
svn update
svn up  # 简写

# 3. 添加文件（Add）
svn add filename
svn add *  # 添加所有文件

# 4. 提交更改（Commit）
svn commit -m "提交说明"
svn ci -m "提交说明"  # 简写

# 5. 查看状态（Status）
svn status
svn st  # 简写

# 6. 查看日志（Log）
svn log
svn log -l 5  # 查看最近5条日志

# 7. 查看差异（Diff）
svn diff
svn diff -r 100:101  # 比较两个版本

# 8. 还原更改（Revert）
svn revert filename

# 9. 删除文件（Delete）
svn delete filename
svn rm filename  # 简写

# 10. 创建分支（Branch）
svn copy http://svn.example.com/repos/trunk \
           http://svn.example.com/repos/branches/feature-1 \
           -m "创建分支"

📊 六、客户端工具对比

工具	平台	类型	特点
TortoiseSVN	Windows	图形化	资源管理器集成，最流行
TortoiseSVN	macOS	图形化	macOS 版本（有限支持）
RabbitVCS	Linux	图形化	Nautilus/Thunar 集成
SmartSVN	跨平台	图形化	专业级，付费
命令行	跨平台	命令行	灵活，适合脚本
IDE 插件	跨平台	集成	Eclipse/IntelliJ 内置支持

⚠️ 七、常见问题解决

1. 安装后 svn 命令无法识别

Windows：

解决方案：将 SVN 安装目录\bin 添加到系统环境变量 Path 中

Linux/macOS：

# 检查是否安装
which svn

# 如未找到，重新安装或检查 PATH
export PATH=$PATH:/usr/local/bin

2. 中文乱码问题

# 设置 SVN 编码
svn config --set global-encoding utf-8

3. 证书验证失败

# 临时跳过证书验证（不推荐生产环境）
svn checkout --trust-server-cert http://svn.example.com/repos/project

# 或永久信任
svn checkout https://svn.example.com/repos/project
# 选择 p 永久接受证书

4. 权限被拒绝

# Linux 检查目录权限
sudo chown -R $USER:$USER /path/to/svn/working/copy
sudo chmod -R 755 /path/to/svn/working/copy

✅ 八、安装验证清单

# 1. 检查 SVN 版本
svn --version

# 2. 测试连接（替换为实际 SVN 服务器地址）
svn info http://svn.example.com/repos/project

# 3. 创建测试版本库
svnadmin create /tmp/test-repo
svn checkout file:///tmp/test-repo test-working-copy

# 4. 测试基本操作
cd test-working-copy
echo "test" > test.txt
svn add test.txt
svn commit -m "test commit"

💡 九、最佳实践建议

建议	说明
使用图形客户端	Windows 推荐 TortoiseSVN，操作直观
定期备份	版本库定期备份到异地
权限管理	合理设置用户权限，避免误操作
提交规范	编写清晰的提交日志说明
分支策略	使用 trunk/branches/tags 标准结构
大文件处理	避免在 SVN 中存储大二进制文件

🔗 十、官方资源链接

资源	链接
官方网站	https://subversion.apache.org/
下载页面	https://subversion.apache.org/packages.html
官方文档	https://subversion.apache.org/docs/
TortoiseSVN	https://tortoisesvn.net/
VisualSVN Server	https://www.visualsvn.com/server/