svn switch 是什么？
svn switch 命令，通常简写为 svn sw，用于将你的工作副本（Working Copy）从一个仓库 URL 切换到另一个仓库 URL。
这个“另一个 URL”通常指向同一个项目的不同分支、不同标签 或不同的版本路径。
核心思想： 它不是在本地创建一个新副本，而是原地修改你当前工作副本的“根 URL”，这意味着你之前所有的本地修改、文件锁定、未提交的更改都会被保留，只是它们现在关联到了新的远程路径。
主要用途
svn switch 的主要用途有以下几种：
- 在分支间切换： 这是最常见的用法，你可能在
trunk上开发，需要切换到feature-branch进行工作，或者切换到release-1.0分支进行 bug 修复。 - 在不同标签（Tag）间切换： 当你需要查看或基于某个历史版本（
v1.2.3）进行工作时，可以切换到对应的标签路径。 - 迁移工作副本： 如果项目的仓库 URL 发生了变化（从
svn://old-server/迁移到svn://new-server/），你可以使用svn switch来更新整个工作副本的根 URL，而无需重新 checkout。 - 跟踪分支的移动： 如果一个分支被移动（例如从
branches/old-name移动到branches/new-name），你可以使用svn switch来让你的工作副本继续跟踪这个分支。
基本语法
svn switch [OPTIONS] SOURCE [PATH]
SOURCE: 目标 URL，这是你想要切换到的新的仓库路径（新的分支或标签的 URL）。PATH(可选): 本地工作副本路径，如果你当前就在工作副本的根目录下，可以省略此参数，否则，需要指定你想要切换的子目录。
常用选项
| 选项 | 缩写 | 描述 |
|---|---|---|
--revision |
-r |
指定要切换到的特定版本号，这对于回溯到旧版本的标签非常有用。 |
--ignore-ancestry |
在切换时忽略文件历史关系，这可以避免在某些情况下（如分支合并后）出现不必要的冲突。 | |
--force |
强制执行切换，即使可能会导致一些问题（如本地修改与目标版本冲突）。 | |
--accept |
指定当发生冲突时如何处理（mine-full, theirs-full）。 |
|
--set-depth |
设置切换后目录的递归深度（infinity, immediates, files）。 |
实践示例
假设我们有以下 SVN 仓库结构：
svn://svn.example.com/project/
├── trunk/
│ └── ...
├── branches/
│ ├── feature-login/
│ └── feature-payment/
└── tags/
└── v1.0/示例 1：从 trunk 切换到 feature-login 分支
-
初始状态：你的工作副本在
trunk。# 切换到 feature-login 分支 svn switch svn://svn.example.com/project/branches/feature-login . # 验证当前 URL svn info
输出会显示
URL: Root: svn://svn.example.com/project/branches/feature-login，表示你已经成功切换。
示例 2：从 trunk 切换到 v1.0 标签（查看历史版本）
-
初始状态：你的工作副本在
trunk。# 切换到 v1.0 标签，并指定版本号 svn switch -r 1234 svn://svn.example.com/project/tags/v1.0 . # 验证当前 URL 和版本 svn info
输出会显示
URL: .../tags/v1.0和Revision: 1234，你的工作副本现在完全对应v1.0标签发布时的状态。
（图片来源网络，侵删）
示例 3：切换时处理本地修改
假设你在 trunk 上修改了 file.txt 但没有提交。
# trunk 下的修改 echo "some new feature" >> file.txt
现在你想切换到 feature-login 分支。
# 尝试切换 svn switch svn://svn.example.com/project/branches/feature-login .
SVN 会允许你切换，因为它发现你的本地修改与目标分支的 file.txt 并不冲突（或者即使冲突，它也会将你的修改带到新分支上），切换后，你仍然可以在 feature-login 分支的上下文中继续处理 file.txt 的修改。
重要提示：如果你的本地修改与目标分支同一文件的修改有冲突，SVN 会提示你解决冲突。svn switch 本身不会自动丢弃你的本地修改。
示例 4：仅切换项目中的某个子模块
假设你的项目结构如下,并且你只想切换 webapp 模块到新分支：
my-project/
├── backend/
└── webapp/# 切换 webapp 目录到新分支，不影响 backend svn switch svn://svn.example.com/project/branches/feature-login ./webapp
svn switch vs. svn update
这是一个非常常见的混淆点,它们的区别至关重要：
| 特性 | svn switch |
svn update |
|---|---|---|
| 作用 | 改变工作副本的根 URL。 | 在 同一个 URL 下更新到最新版本。 |
| 类比 | 更换电视的“频道”（从 CNN 切换到 BBC）。 | 在当前频道上，接收最新的“节目内容”。 |
| 结果 | 工作副本指向一个新的、不同的代码路径（如分支）。 | 工作副本保持在同一个代码路径，但内容更新到了服务器上的新版本。 |
| 常用场景 | 在分支/标签间来回切换。 | 获取团队成员的最新提交，同步你的本地代码。 |
最佳实践和注意事项
- 保持工作副本干净：在执行
svn switch之前，最好先提交所有本地修改 (svn commit)，或者至少确保没有未解决的冲突，这样可以避免混淆。 - 理解“祖先关系”：
svn switch会尝试保持文件的历史关系，如果源和目标路径中的文件有共同祖先，切换会更顺利，如果分支结构复杂，可能会遇到一些意想不到的行为，此时可以使用--ignore-ancestry选项。 - 注意文件状态：切换后，一些文件的状态可能会发生变化（从
normal变为modified，如果新版本中该文件有改动），运行svn status检查文件状态总是一个好习惯。 - 与
svn merge结合使用：svn switch和svn merge是协同工作的，你通常用svn switch到一个分支进行开发，开发完成后，再用svn merge将你的变更合并回trunk或其他分支。
svn switch 是 SVN 版本控制中管理分支和标签的利器，它允许你灵活地在不同的开发线之间移动，同时保留你的本地工作进度，理解它与 svn update 的区别，并遵循最佳实践，可以让你更高效地使用 SVN 进行协作开发。
