WebStorm所有SVN功能依赖本地svn命令行工具；需在终端执行svn --version验证可用性，若失败则重装TortoiseSVN并勾选“Command line client tools”或macOS用brew install svn，再于Settings→Version Control→Subversion中填对路径并启用Use command line client，最后通过VCS→Enable Version Control Integration手动绑定Subversion。
确认本地 svn 命令行是否真正可用
WebStorm 所有 SVN 功能（commit、update、revert）都依赖系统级 svn 可执行文件，不是图形界面工具本身。常见错误是只装了 TortoiseSVN 但安装时没勾选 “Command line client tools”，导致 svn --version 报错。
- macOS：打开终端，运行
which svn；若返回空，或svn --version提示command not found，说明未安装或未加入$PATH；Xcode 自带的 svn（常为 1.9.x）易与新版 WebStorm 冲突，建议用brew install svn并确认/usr/local/bin/svn存在且可执行 - Windows：打开命令提示符，运行
where svn；典型有效路径是C:\Program Files\TortoiseSVN\bin\svn.exe；若装的是 SlikSVN，则路径类似C:\Program Files\SlikSvn\bin\svn.exe - 路径含空格（如
C:\Program Files\...）无需加引号，WebStorm 能正确解析
在 Settings 中填对 svn 路径并启用命令行模式
新版 WebStorm（2020.3+）已内置 SVN 支持，无需插件，但必须手动指定路径 —— 勾选 Use command line client 是前提，否则所有 SVN 操作静默失败。
- 打开
Settings（macOS ⌘+,，Windows/Linux Ctrl+Alt+S），进入Version Control → Subversion - 勾选
Use command line client，右侧输入框填入完整路径：/usr/local/bin/svn（macOS）或C:\Program Files\TortoiseSVN\bin\svn.exe（Windows） - 取消勾选
Use default SVN configuration directory，避免读取旧配置引发认证或代理问题 - 点
Test按钮验证；失败时检查：路径拼写是否多空格/斜杠方向错误、文件权限是否被杀毒软件拦截、是否误填了tortoiseplink.exe或tortoiseProc.exe（这些不支持 CLI）
项目根目录必须手动启用 Subversion 集成
即使 svn 路径完全正确，右键菜单仍不显示 “Subversion”，大概率是因为项目未绑定 VCS 类型 —— WebStorm 不会自动识别 .svn 文件夹并启用 SVN。
- 在项目根目录右键 → 若无 SVN 菜单项，先点顶部菜单
VCS → Enable Version Control Integration… - 下拉框中**必须明确选择
Subversion**（不是 Git，不是留空，也不是 “None”） - 启用后，项目根目录图标会出现浅蓝边框，文件名旁出现颜色标记：
绿色 = added、蓝色 = modified、红色 = missing - 若之前启用了 Git，WebStorm 会缓存 VCS 类型；需先
VCS → Disable Version Control Integration，再重新启用 Subversion
修改本地工作副本的 SVN 地址（重定向）
当仓库地址变更（如迁移到新 VisualSVN 实例或调整 URL 路径），不能仅改 Settings 里的配置 —— WebStorm 不管理工作副本元数据，它读取的是 .svn/wc.db 里的实际 URL。
- 直接在终端 / 命令行执行：
svn switch --relocate 旧URL 新URL（SVN 1.6 及更早）或svn relocate 旧URL 新URL（已废弃） - 推荐做法（兼容所有版本）：
svn switch --set-depth exclude . && svn switch 新URL，或更稳妥地：svn info确认当前 URL 后，用svn switch ^/new/path（相对路径）或完整新 URL - 切勿手动删除
.svn文件夹再重新 checkout —— 这会丢失本地未提交修改和属性（如svn:externals） - WebStorm 的
VCS → Subversion → Relocate…菜单项本质就是调用svn switch --relocate，但仅在 SVN 1.8–1.9 有效；1.10+ 已移除该子命令，此时该菜单会报错，必须走命令行
实际改本地修改前，最易忽略的是：WebStorm 的 Changes 工具窗口默认只显示 “Local” 变更，但如果你刚启用 SVN 集成，它可能还没扫描完所有文件 —— 等几秒，或手动右键项目根目录 → Subversion → Refresh Status。否则你会以为“改了没反应”。
