TortoiseSVN安装使用

封面图 • 2025-11-28 • Windows

TortoiseSVN 是一个基于 **Subversion (SVN)** 的版本控制工具，它以 Windows 资源管理器插件的形式存在，使开发者可以更方便地进行代码的版本管理。下面是 **TortoiseSVN 的安装与使用指南**。

---

## 一、TortoiseSVN 安装

### 1. 下载安装包
访问官网下载最新版本：
- 官网地址：[https://tortoisesvn.net/](https://tortoisesvn.net/)
- 选择适合你系统的版本（32位或64位）。

### 2. 安装步骤
1. 双击下载的 `.exe` 文件。
2. 按照提示完成安装过程。
   - 建议勾选 **“Add to context menu”** 和 **“Install service”**。
   - 如果你使用的是中文系统，建议安装中文语言包。
3. 安装完成后重启资源管理器（右键任务栏 -> 重启资源管理器）或重启电脑。

---

## 二、TortoiseSVN 使用教程

### 1. 创建 SVN 仓库（本地或远程）

#### 本地仓库创建
1. 新建一个文件夹作为仓库目录（如 `D:\svn\myproject`）。
2. 右键该文件夹 -> **TortoiseSVN -> Create Repository here**。
3. 选择仓库类型（推荐 **FSFS**）。

#### 远程仓库（如使用 VisualSVN Server 或 Apache + Subversion）
你需要配置好 SVN 服务器，然后在客户端连接。

---

### 2. 导入项目到 SVN 仓库

1. 在本地创建一个项目文件夹（如 `D:\projects\myapp`）。
2. 右键该文件夹 -> **TortoiseSVN -> Import**。
3. 输入 SVN 仓库地址（如 `file:///D:/svn/myproject` 或 `http://yourserver/svn/myproject`）。
4. 输入用户名和密码（如果需要），点击 **OK**。
5. 等待导入完成。

> 注意：导入后，本地文件夹会变成 SVN 工作副本。

---

### 3. 获取工作副本（Checkout）

1. 右键桌面或文件夹 -> **SVN Checkout**。
2. 输入仓库地址（如 `http://yourserver/svn/myproject`）。
3. 设置本地保存路径（如 `D:\work\myapp`）。
4. 点击 **OK**，等待下载。

---

### 4. 常用操作（右键菜单）

| 操作 | 描述 |
|------|------|
| **SVN Update** | 更新本地代码到最新版本 |
| **SVN Commit** | 提交本地修改到仓库 |
| **SVN Diff** | 查看当前文件与仓库版本的差异 |
| **Show Log** | 查看提交历史 |
| **Revert** | 回滚未提交的更改 |
| **Lock / Unlock** | 锁定文件防止多人同时编辑 |
| **Properties** | 设置文件属性（如 MIME 类型） |

---

### 5. 解决冲突

当多人同时修改同一文件时，可能会发生冲突：

1. 执行 **SVN Update** 时出现冲突。
2. TortoiseSVN 会弹出冲突窗口。
3. 选择 **Merge** 或 **Edit conflict** 来解决冲突。
4. 解决后标记为 **Resolved**，再执行 **Commit**。

---

### 6. 分支与标签（Branch & Tag）

#### 创建分支
1. 右键项目文件夹 -> **TortoiseSVN -> Branch/Tag**。
2. 输入目标路径（如 `http://yourserver/svn/myproject/branches/v1.0`）。
3. 确认后，TortoiseSVN 会复制当前版本到新分支。

#### 创建标签
1. 右键项目文件夹 -> **TortoiseSVN -> Branch/Tag**。
2. 输入目标路径（如 `http://yourserver/svn/myproject/tags/v1.0`）。
3. 标签通常用于发布版本，不建议再修改。

---

## 三、常见问题

### Q1: TortoiseSVN 安装后没有右键菜单？
- 可能未正确安装，重新运行安装程序，确保勾选了 **"Add to context menu"**。
- 重启资源管理器或电脑。

### Q2: 提交时提示“Authentication failed”？
- 检查用户名和密码是否正确。
- 如果是远程仓库，检查网络是否正常。

### Q3: 如何查看提交日志？
- 右键文件夹 -> **Show Log**，可以看到所有提交记录。

---

## 四、推荐工具搭配

| 工具 | 作用 |
|------|------|
| **TortoiseSVN** | 版本控制核心工具 |
| **VisualSVN Server** | 本地 SVN 服务器（Windows） |
| **SVNKit / JavaHL** | Java 项目中使用 SVN |
| **Eclipse / IntelliJ IDEA** | 集成 SVN 插件 |

---

## 五、学习资源

- [TortoiseSVN 官方文档](https://tortoisesvn.net/docs/release-notes.html)
- [Subversion 中文手册](https://svnbook.red-bean.com/zh/1.8/)
- [TortoiseSVN 教程视频（B站）](https://www.bilibili.com/)

---

如果你有具体使用场景（比如团队协作、本地开发、CI/CD 集成等），我可以提供更详细的指导！需要我帮你写一个简单的 SVN 工作流程吗？