SVN on 吾爱主机

SVN命令行完全指南：从入门到实战

Fri, 26 Jun 2026 16:30:00 +0000

SVN 简介

Apache Subversion（SVN）是一个集中式版本控制系统，曾是最流行的版本控制工具。虽然 Git 已成为主流，但许多企业和遗留项目仍在使用 SVN。

SVN vs Git 核心区别：

特性	SVN	Git
架构	集中式	分布式
离线工作	❌ 不支持	✅ 完整支持
分支成本	较高	极低
学习曲线	低	中等
适用场景	二进制文件、大型文件	代码项目

安装 SVN

# Ubuntu/Debian
sudo apt install subversion

# CentOS/RHEL
sudo yum install subversion

# macOS
brew install subversion

# 验证安装
svn --version

基本操作

1. 检出仓库

# 检出整个仓库
svn checkout https://svn.example.com/repo/project
svn checkout https://svn.example.com/repo/project my-local-dir

# 检出指定版本
svn checkout -r 1234 https://svn.example.com/repo/project

# 简写形式
svn co https://svn.example.com/repo/project

2. 更新代码

# 更新到最新版本
svn update
svn up

# 更新到指定版本
svn update -r 1234

# 更新指定目录
svn update src/

3. 查看状态

# 查看工作副本状态
svn status
svn st

# 状态标识说明：
# ? 未版本控制
# A 已添加
# M 已修改
# D 已删除
# C 冲突
# ! 缺失
# ~ 类型改变

4. 添加文件

# 添加单个文件
svn add file.txt

# 添加目录
svn add src/

# 递归添加所有新文件
svn add --force .

# 添加文件到版本控制（仅调度，不会自动提交，需后续 svn commit）
svn add file.txt

5. 提交更改

# 提交所有更改
svn commit -m "提交说明"
svn ci -m "提交说明"

# 提交指定文件
svn commit file.txt -m "修改文件"

# 提交多个文件
svn commit file1.txt file2.txt -m "批量修改"

6. 删除文件

# 删除文件
svn delete file.txt
svn del file.txt
svn rm file.txt

# 删除并提交
svn delete file.txt -m "删除文件"

# 删除本地文件但保留版本控制
svn delete --keep-local file.txt

7. 移动/重命名

# 移动文件
svn move old.txt new.txt
svn mv old.txt new.txt
svn rename old.txt new.txt

查看信息

1. 查看日志

# 查看完整日志
svn log

# 查看最近N条日志
svn log -l 10

# 查看指定文件日志
svn log file.txt

# 查看详细日志
svn log -v

# 按日期筛选
svn log -r {2024-01-01}:{2024-12-31}

2. 查看差异

# 查看工作副本与仓库差异
svn diff

# 查看指定文件差异
svn diff file.txt

# 查看两个版本差异
svn diff -r 1234:1235

# 查看指定版本的变更
svn diff -c 1234

3. 查看文件内容

# 查看文件内容
svn cat file.txt

# 查看指定版本的文件内容
svn cat -r 1234 file.txt

# 查看文件信息
svn info file.txt

# 查看仓库信息
svn info

4. 查看列表

# 列出目录内容
svn list https://svn.example.com/repo/

# 递归列出
svn list -R https://svn.example.com/repo/

# 显示详细信息
svn list -v https://svn.example.com/repo/

分支与标签

1. 创建分支

# 标准目录结构方式
svn copy https://svn.example.com/repo/trunk \
 https://svn.example.com/repo/branches/feature-login \
 -m "创建feature-login分支"

# 本地方式
svn copy trunk branches/feature-login
svn commit -m "创建feature-login分支"

2. 切换分支

# 切换到分支
svn switch https://svn.example.com/repo/branches/feature-login

# 切换回主干
svn switch https://svn.example.com/repo/trunk

3. 合并分支

# 切换到目标分支（通常是trunk）
svn switch https://svn.example.com/repo/trunk

# 合并分支
svn merge https://svn.example.com/repo/branches/feature-login

# 解决冲突后提交
svn commit -m "合并feature-login分支"

# 查看合并信息
svn mergeinfo https://svn.example.com/repo/branches/feature-login

4. 创建标签

# 创建标签（标签是分支的只读副本）
svn copy https://svn.example.com/repo/trunk \
 https://svn.example.com/repo/tags/v1.0.0 \
 -m "创建v1.0.0标签"

冲突解决

1. 查看冲突

# 更新时出现冲突
svn update
# 输出：C file.txt

# 查看冲突状态
svn status
# 输出：C file.txt

2. 解决冲突

# 方式1：接受当前工作副本内容（手工解决冲突后常用）
svn resolve --accept working file.txt

# 方式2：接受本地版本
svn resolve --accept mine-full file.txt

# 方式3：接受服务器版本
svn resolve --accept theirs-full file.txt

# 方式4：手动编辑后标记解决
# 编辑 file.txt，解决冲突标记
svn resolve --accept working file.txt

3. 冲突标记

<<<<<<< .mine
你的修改
=======
服务器版本
>>>>>>> .r1234

高级操作

1. 版本回退

# 回退单个文件到指定版本
svn update -r 1234 file.txt

# 回退整个工作副本
svn update -r 1234

# 撤销已提交的修改（反向合并）
svn merge -r 1234:1233 .
svn commit -m "回退r1234的修改"

2. 忽略文件

# 设置忽略模式
svn propset svn:ignore "*.log" .
svn propset svn:ignore -F .svnignore .

# 递归设置
svn propset svn:global-ignores "*.o *.a" .

# 查看忽略设置
svn propget svn:ignore .

# 编辑忽略列表
svn propedit svn:ignore .

3. 属性操作

# 设置属性
svn propset svn:keywords "Author Date Rev" file.txt
svn propset svn:eol-style native file.txt
svn propset svn:mime-type image/png image.png

# 查看属性
svn proplist file.txt
svn propget svn:keywords file.txt

# 删除属性
svn propdel svn:keywords file.txt

4. 导出代码

# 导出干净代码（无.svn目录）
svn export https://svn.example.com/repo/trunk ./export

# 导出本地工作副本
svn export . ./clean-copy

5. 清理

# 清理工作副本锁
svn cleanup

# 删除未版本控制的文件
svn status | grep "^?" | awk '{print $2}' | xargs rm -rf

SVN 标准目录结构

repo/
├── trunk/ # 主开发线
│ ├── src/
│ └── ...
├── branches/ # 分支
│ ├── feature-login/
│ └── release-1.0/
└── tags/ # 标签（只读）
 ├── v1.0.0/
 └── v1.1.0/

常用别名配置

# ~/.bashrc 或 ~/.zshrc
alias ss='svn status'
alias su='svn update'
alias sci='svn commit -m'
alias sdiff='svn diff'
alias slog='svn log -l 10'
alias sinfo='svn info'

SVN 迁移到 Git

# 使用 git-svn
git svn clone https://svn.example.com/repo --stdlayout --no-metadata

# 作者映射
git svn clone https://svn.example.com/repo \
 --stdlayout \
 --authors-file=authors.txt \
 --no-metadata

# authors.txt 格式
# svnuser = Git User <git@email.com>

常见问题

1. 工作副本锁定

# 清理锁定
svn cleanup

# 如果不行，删除锁文件
find . -name "*.lock" -delete
svn cleanup

2. 无法提交

# 检查是否有冲突未解决
svn status | grep "^C"

# 解决冲突后
svn resolved file.txt
svn commit -m "解决冲突"

3. 版本号混乱

# 查看当前版本
svnversion

# 查看详细信息
svn info

总结

SVN 虽然不如 Git 流行，但在特定场景仍有价值：

二进制文件管理：SVN 对大文件支持更好
精细权限控制：支持目录级别的权限管理
简单易学：对新手更友好
企业遗留系统：许多企业仍在使用

掌握 SVN 命令对于维护遗留项目和特定场景仍然很有必要。

在 SVN 中创建新仓库并添加分支与标签

Mon, 23 Jun 2025 09:17:53 +0800

完整指南：在 SVN 中创建新仓库并添加分支与标签

下面是一个完整的解决方案，帮助您创建新仓库、添加初始代码，并建立分支与标签结构。

🌟 完整操作流程

第一步：创建新仓库并初始化标准结构

# 创建仓库目录
sudo mkdir -p /var/www/svn/new_project
sudo svnadmin create /var/www/svn/new_project

# 设置权限
sudo chown -R www-data:www-data /var/www/svn/new_project
sudo chmod -R 775 /var/www/svn/new_project

# 初始化标准目录结构
svn mkdir -m "创建标准结构" \
http://your-svn-server/svn/new_project/trunk \
http://your-svn-server/svn/new_project/branches \
http://your-svn-server/svn/new_project/tags

第二步：添加初始代码到主干(trunk)

# 1. 检出主干
svn checkout http://your-svn-server/svn/new_project/trunk new_project
cd new_project

# 2. 添加项目文件
mkdir src docs config
echo "print('Hello SVN!')" > src/main.py
echo "# Project Documentation" > docs/README.md
echo "DATABASE_URL=sqlite:///db.sqlite3" > config/.env

# 3. 提交初始代码
svn add src docs config
svn commit -m "初始项目提交：添加核心文件"

第三步：创建开发分支

# 从主干创建特性分支
svn copy -m "创建开发分支" \
http://your-svn-server/svn/new_project/trunk \
http://your-svn-server/svn/new_project/branches/develop

第四步：创建标签（发布版本）

# 创建第一个发布标签 (v1.0.0)
svn copy -m "发布版本 v1.0.0" \
http://your-svn-server/svn/new_project/trunk \
http://your-svn-server/svn/new_project/tags/v1.0.0

第五步：在分支上开发并合并回主干

# 1. 切换到开发分支
svn switch http://your-svn-server/svn/new_project/branches/develop

# 2. 进行开发工作
echo "def new_feature():" >> src/main.py
echo " print('Added in develop branch')" >> src/main.py

# 3. 提交分支更改
svn commit -m "在develop分支添加新功能"

# 4. 切换回主干
svn switch http://your-svn-server/svn/new_project/trunk

# 5. 合并分支到主干
svn merge http://your-svn-server/svn/new_project/branches/develop
svn commit -m "将develop分支合并到主干"

第六步：创建热修复分支（紧急修复）

# 1. 从标签创建热修复分支
svn copy -m "创建热修复分支" \
http://your-svn-server/svn/new_project/tags/v1.0.0 \
http://your-svn-server/svn/new_project/branches/hotfix-issue-123

# 2. 切换到热修复分支
svn switch http://your-svn-server/svn/new_project/branches/hotfix-issue-123

# 3. 进行修复
echo "# 紧急修复补丁" >> src/patch.py
svn add src/patch.py
svn commit -m "修复问题 #123"

# 4. 创建新标签 (v1.0.1)
svn copy -m "发布修复版本 v1.0.1" \
http://your-svn-server/svn/new_project/branches/hotfix-issue-123 \
http://your-svn-server/svn/new_project/tags/v1.0.1

📊 SVN 分支/标签管理最佳实践

类型	命名规范	用途	生命周期
主干(trunk)	`/trunk`	主要开发线	永久存在
开发分支	`/branches/feature-*`	新功能开发	功能完成后删除
发布分支	`/branches/release-*`	版本测试准备	发布后删除
热修复分支	`/branches/hotfix-*`	生产环境修复	修复后删除
版本标签	`/tags/v..*`	稳定版本快照	永久保留

🔍 验证仓库结构

# 查看仓库完整结构
svn ls -R http://your-svn-server/svn/new_project

# 预期输出：
branches/
branches/develop/
branches/hotfix-issue-123/
tags/
tags/v1.0.0/
tags/v1.0.0/src/
tags/v1.0.0/src/main.py
tags/v1.0.0/docs/
tags/v1.0.0/docs/README.md
tags/v1.0.0/config/
tags/v1.0.0/config/.env
tags/v1.0.1/
tags/v1.0.1/src/
tags/v1.0.1/src/main.py
tags/v1.0.1/src/patch.py
tags/v1.0.1/docs/
tags/v1.0.1/docs/README.md
tags/v1.0.1/config/
tags/v1.0.1/config/.env
trunk/
trunk/src/
trunk/src/main.py
trunk/docs/
trunk/docs/README.md
trunk/config/
trunk/config/.env

💡 高级分支管理技巧

1. 创建特性分支

svn copy -m "创建登录功能分支" \
http://your-svn-server/svn/new_project/trunk \
http://your-svn-server/svn/new_project/branches/feature-login

2. 合并特定修订

# 只合并修订版100-105的更改
svn merge -r 100:105 \
http://your-svn-server/svn/new_project/branches/feature-login

3. 分支重命名

svn move -m "重命名分支" \
http://your-svn-server/svn/new_project/branches/old-name \
http://your-svn-server/svn/new_project/branches/new-name

4. 查看分支差异

svn diff \
http://your-svn-server/svn/new_project/trunk \
http://your-svn-server/svn/new_project/branches/feature-login

⚙️ 自动化脚本示例

创建初始化脚本 init_svn_project.sh:

#!/bin/bash

PROJECT_NAME=&#36;1
SVN_ROOT="http://your-svn-server/svn"

# 创建仓库
svnadmin create /var/www/svn/&#36;PROJECT_NAME
chown -R www-data:www-data /var/www/svn/&#36;PROJECT_NAME

# 初始化结构
svn mkdir -m "初始化结构" \
&#36;SVN_ROOT/&#36;PROJECT_NAME/trunk \
&#36;SVN_ROOT/&#36;PROJECT_NAME/branches \
&#36;SVN_ROOT/&#36;PROJECT_NAME/tags

# 检出主干
svn checkout &#36;SVN_ROOT/&#36;PROJECT_NAME/trunk &#36;{PROJECT_NAME}_trunk

# 添加基础文件
cd &#36;{PROJECT_NAME}_trunk
mkdir src docs
echo "# &#36;PROJECT_NAME" > docs/README.md
svn add src docs
svn commit -m "初始提交"

# 创建开发分支
svn copy -m "创建开发分支" \
&#36;SVN_ROOT/&#36;PROJECT_NAME/trunk \
&#36;SVN_ROOT/&#36;PROJECT_NAME/branches/develop

echo "项目 &#36;PROJECT_NAME 初始化完成!"
echo "主干路径: &#36;SVN_ROOT/&#36;PROJECT_NAME/trunk"
echo "开发分支: &#36;SVN_ROOT/&#36;PROJECT_NAME/branches/develop"

使用方式：

chmod +x init_svn_project.sh
./init_svn_project.sh my_new_project

📌 关键注意事项

权限管理：确保在 /etc/subversion/authz 中配置好分支/标签权限
合并策略：定期将主干变更合并到长期分支
标签不可变：创建标签后不要修改，需要修改时创建新标签
分支清理：定期删除已合并的旧分支
备份策略：定期备份仓库

svnadmin dump /var/www/svn/new_project > new_project_backup.svndump

通过这个完整流程，您可以轻松创建新仓库，建立标准的分支和标签结构，并开始高效管理您的项目开发周期。

搭建一个 SVN 仓库

Mon, 23 Jun 2025 09:15:42 +0800

搭建一个 SVN 仓库主要涉及两个部分：安装 SVN 服务器软件 和 创建仓库本身。以下是详细的步骤，适用于 Windows 和 Linux 系统：

🧱 核心步骤概览

安装 SVN 服务器软件
创建仓库
配置访问权限
启动服务
客户端访问

🪟 一、Windows 系统搭建 (推荐使用 VisualSVN Server)

这是最简单快捷的方式，适合个人或小型团队。

下载并安装 VisualSVN Server
- 访问官方网站: https://www.visualsvn.com/server/
- 下载免费的 VisualSVN Server (通常选择最新的 Community 版本)。
- 运行安装程序，按照提示进行安装。安装过程中需要注意：
  - 安装位置： 选择合适的路径存放仓库文件（建议空间充足）。
  - 仓库位置： 指定仓库根目录（Repositories）。
  - 服务器端口： 默认是 80 (HTTP) 和 443 (HTTPS)。如果端口冲突，可以修改（例如改成 8080/8443）。
  - 认证方式： 选择 Subversion authentication 或 Windows authentication。对于独立服务器，Subversion authentication 更常用。
  - 使用默认选项创建初始仓库和管理员账户通常很方便。
创建仓库
- 安装完成后，启动 VisualSVN Server Manager (管理控制台)。
- 在左侧树形菜单中，右键点击 Repositories。
- 选择 Create New Repository...。
- 输入仓库名称（例如 my_project）。
- 选择仓库结构：
  - Empty repository：完全空仓库。
  - Single-project repository (with trunk, branches, tags)：推荐！创建标准的 trunk, branches, tags 目录结构。
  - Multi-project repository (with projects root)：创建一个 projects 目录，适合存放多个项目。
- 选择仓库访问权限：
  - All Subversion users have Read/Write access：所有 SVN 用户可读写（初期测试方便）。
  - Customize permissions：自定义权限（生产环境推荐）。
- 点击 Create。
配置访问权限 (可选但推荐)
- 在 VisualSVN Server Manager 中，右键点击你刚创建的仓库。
- 选择 Properties。
- 切换到 Security 标签页。
- 在这里可以添加/删除用户或用户组，并为它们分配权限：
  - No Access：无权限。
  - Read Only：只能读取。
  - Read / Write：可读取和提交。
- 管理用户/用户组：在左侧树形菜单的 Users 和 Groups 节点上右键创建和管理。
获取仓库 URL
- 在 VisualSVN Server Manager 中，右键点击你的仓库。
- 选择 Copy URL to Clipboard。
- 仓库 URL 格式通常是：https://<服务器名或IP地址>:<端口>/svn/<仓库名> 或 http://<服务器名或IP地址>:<端口>/svn/<仓库名> (如果使用 HTTPS)。
启动/停止服务
- VisualSVN Server 安装后会作为 Windows 服务自动启动。
- 可以在 VisualSVN Server Manager 的状态栏查看服务状态，或在 Windows 服务管理器中管理 VisualSVN Server 服务。

🐧 二、Linux 系统搭建 (常用 Apache + mod_dav_svn)

这是更灵活、适合生产环境的方式，利用 Apache HTTP Server 提供 WebDAV/HTTP(S) 访问。

安装必要软件包 (以 Ubuntu/Debian 为例)
```
sudo apt update
sudo apt install subversion apache2 libapache2-mod-svn
```
- subversion: SVN 客户端和服务器工具。
- apache2: Apache HTTP Server。
- libapache2-mod-svn: Apache 的 SVN 模块 (mod_dav_svn, mod_authz_svn)。

启用必要的 Apache 模块

sudo a2enmod dav
sudo a2enmod dav_svn
sudo a2enmod authz_svn # 如果需要基于路径的权限控制，强烈推荐启用
sudo systemctl restart apache2

创建 SVN 仓库目录

sudo mkdir -p /var/www/svn # 选择一个合适的父目录，如 /opt/svn 或 /srv/svn 也可以

创建仓库
```
sudo svnadmin create /var/www/svn/my_project
```
- 这会在 /var/www/svn/my_project 下创建仓库结构。

设置仓库目录权限

让 Apache 用户（通常是 www-data）拥有仓库目录的所有权：
```
sudo chown -R www-data:www-data /var/www/svn/my_project
```

设置合适的权限：

sudo chmod -R 770 /var/www/svn/my_project # 允许 www-data 组读写执行
# 或者更精细的权限控制

配置 Apache 访问仓库

创建或编辑 Apache 的 SVN 配置文件：

sudo nano /etc/apache2/sites-available/svn.conf # 或修改已有的 default-ssl.conf 或新建一个

在配置文件中添加类似以下内容：

# 加载 SVN 模块 (通常已由 a2enmod 完成，这里确保)
LoadModule dav_svn_module /usr/lib/apache2/modules/mod_dav_svn.so
LoadModule authz_svn_module /usr/lib/apache2/modules/mod_authz_svn.so

<Location /svn> # 客户端访问的 URL 路径前缀
 DAV svn
 SVNParentPath /var/www/svn # 指向仓库的父目录

 # 认证配置 (基本认证)
 AuthType Basic
 AuthName "Subversion Repository"
 AuthUserFile /etc/subversion/passwd # 用户密码文件存放位置
 Require valid-user

 # 授权配置 (可选但推荐)
 AuthzSVNAccessFile /etc/subversion/authz # 权限控制文件
</Location>

关键配置项说明:
- <Location /svn>: 定义客户端通过 http(s)://your-server/svn/ 访问仓库。
- SVNParentPath /var/www/svn: 指定所有仓库的父目录。Apache 会自动将 <Location> 路径后的部分 (/svn/ 后面的部分) 映射到这个目录下的子目录（即仓库名）。使用 SVNPath 可以配置单个仓库。
- AuthType Basic: 使用 HTTP 基本认证。
- AuthName: 认证域提示。
- AuthUserFile: 存放用户名和加密密码的文件路径。
- Require valid-user: 要求有效用户才能访问。
- AuthzSVNAccessFile: 定义更细粒度权限（基于路径、用户/组）的文件路径。

创建用户密码文件

sudo htpasswd -c /etc/subversion/passwd username1 # -c 选项只在第一次创建文件时使用
sudo htpasswd /etc/subversion/passwd username2 # 后续添加用户去掉 -c

系统会提示你为每个用户设置密码。

(可选但推荐) 创建和配置权限文件 (authz)

创建文件：
```
sudo nano /etc/subversion/authz
```

编辑内容示例：

[groups]
developers = user1, user2
admins = user3

[/] # 根目录，指所有仓库
* = r # 所有人只读 (匿名访问，可选)
@developers = rw # developers 组读写

[my_project:/] # 指定仓库 my_project 的根目录
@developers = rw
@admins = rw
user4 = r # 单独用户 user4 只读

[my_project:/secret] # my_project 仓库下的 secret 目录
@admins = rw
* = # 其他人无权限 (禁止访问)

保存文件，并确保 Apache 用户 (www-data) 有读取权限。

启用配置并重启 Apache

sudo a2ensite svn.conf # 如果你新建了 svn.conf 文件
sudo systemctl reload apache2 # 或 sudo systemctl restart apache2

获取仓库 URL
- 仓库 URL 格式通常是：http://<服务器名或IP地址>/svn/my_project 或 https://<服务器名或IP地址>/svn/my_project (如果配置了 SSL)。

🧪 三、测试与使用仓库

安装 SVN 客户端
- Windows: 推荐 TortoiseSVN (集成到文件管理器)。
- Linux: 安装 subversion 包 (sudo apt install subversion) 使用命令行 svn。
- macOS: 通常自带 svn 命令行，或使用 Cornerstone 等图形客户端。
检出仓库 (Checkout)
- 命令行:
```
svn checkout http://your-server/svn/my_project my_project_working_copy
```
  (会提示输入在 passwd 文件中设置的用户名和密码)
- TortoiseSVN: 在空白文件夹右键 -> SVN Checkout...，输入仓库 URL 和目标路径。
添加文件、提交更改 (Commit)
- 在工作拷贝中添加、修改或删除文件。
- 命令行:
```
svn add filename
svn commit -m "提交说明"
```
- TortoiseSVN: 在工作拷贝内右键 -> SVN Commit...，选择要提交的文件，填写日志信息。

📦 四、备份仓库 (重要！)

使用 svnadmin dump:
```
svnadmin dump /var/www/svn/my_project > my_project_backup_&#36;(date +%Y%m%d).svndump
```
- 将生成的 .svndump 文件安全存储。
- 恢复：svnadmin load /path/to/new/repository < my_project_backup.svndump
使用 svnadmin hotcopy:
```
svnadmin hotcopy /var/www/svn/my_project /path/to/backup/my_project_&#36;(date +%Y%m%d)
```
- 创建仓库的完整热拷贝（在运行时也可以进行，但最好在低负载时操作）。这个拷贝本身就是一个有效的仓库。
文件系统备份: 在 SVN 服务停止时，直接备份整个仓库目录 (/var/www/svn/my_project)。不推荐在服务运行时直接复制文件系统。

📌 总结

Windows (简便): 安装 VisualSVN Server -> 创建仓库 -> 配置用户权限 -> 获取 URL -> 客户端检出使用。
Linux (灵活/生产): 安装 subversion, apache2, libapache2-mod-svn -> 创建仓库 -> 配置 Apache (svn.conf) -> 创建用户 (htpasswd) -> (可选)配置细粒度权限 (authz) -> 重启 Apache -> 客户端检出使用。
务必进行仓库备份！
权限配置 对于多用户协作至关重要，请根据团队结构认真规划。

选择哪种方式取决于你的操作系统偏好、技术熟悉度和团队规模需求。VisualSVN Server 在 Windows 上提供了极佳的开箱即用体验，而 Apache 方案在 Linux 上更标准且功能强大灵活。💻🔧