docs(SVN): 补充 SVN 仓库地址变更(Relocate)使用指南

- 新增使用命令行执行 svn relocate 的详细步骤和参数说明
- 添加验证 relocate 成功的方法,即使用 svn info 查看 URL更新情况
- 说明 IntelliJ IDEA 中执行 Relocate 的操作流程
- 列出使用 Relocate 时的注意事项,包含提交更改、备份、权限和证书等
- 解答常见问题,如 "Repository UUID mismatch" 和 relocate 后无法更新的解决办法
This commit is contained in:
liumangmang
2026-02-10 10:26:10 +08:00
parent 9dda49b396
commit eaab26940d

View File

@@ -338,3 +338,73 @@ sudo iptables -A INPUT -p tcp --dport 48080 -j DROP
> 这是在类似"只能通过某台中间机访问 SVN"情况下的最佳实践。
---
## 十一 SVN 仓库地址变更Relocate
当 SVN 服务器地址发生变化(如 IP 变更、端口变更或域名变更)时,需要使用 `svn relocate` 命令更新本地工作副本的仓库地址,而无需重新检出代码。
### 11.1 使用命令行 Relocate
如果你习惯使用终端CMD, PowerShell, Bash可以使用 `svn relocate` 命令。
**步骤**
1. 打开终端,`cd` 进入你的项目目录
2. 执行以下命令:
```bash
svn relocate https://10.6.220.216:48080/svn/houtai/ https://10.6.221.149:48080/svn/houtai/
```
**参数说明**
- 第一个 URL旧的仓库地址
- 第二个 URL新的仓库地址
或者,如果你已经在项目根目录下,通常只需要简写新地址:
```bash
svn relocate https://10.6.221.149:48080/svn/houtai/
```
### 11.2 验证 Relocate 是否成功
```bash
svn info
```
查看输出中的 `URL:` 字段是否已更新为新地址。
### 11.3 IDEA 中 Relocate
如果你使用 IntelliJ IDEA
1. 打开项目,点击菜单 `VCS``Subversion``Relocate`
2. 在弹出的对话框中:
- **From URL**:旧地址
- **To URL**:新地址
3. 点击 **OK** 完成切换
### 11.4 注意事项
| 注意点 | 说明 |
| :--- | :--- |
| **先提交本地修改** | relocate 前确保没有未提交的更改,避免冲突 |
| **备份工作副本** | 重要项目建议先备份,防止意外 |
| **检查权限** | 新地址需要相同的 SVN 认证权限 |
| **SSL 证书** | 如果新地址证书不同,需要重新信任 |
| **Relocate vs Switch** | Relocate 用于服务器地址变更Switch 用于在同一仓库内切换分支 |
### 11.5 常见问题
**Q: 提示 "Repository UUID mismatch"**
A: 表示新旧地址指向的仓库不是同一个。确认地址是否正确,或者是否需要重新检出。
**Q: Relocate 后无法更新?**
A: 检查:
- 新地址是否可访问
- 认证信息是否正确
- 防火墙是否放行了新端口
---