WebStorm 的 SVN 功能依赖本地 svn 命令行工具，需正确安装、配置路径、启用 Subversion 集成并执行 Checkout；常见问题包括未装命令行工具、路径错误、未启用集成或未重新 Checkout 导致地址失效。
WebStorm 本身不带 SVN 客户端，所有 SVN 操作都依赖你本地已安装且可调用的 svn 命令行工具；路径配错、命令不可达、或项目未启用 Subversion 集成，都会导致 Checkout 失败、右键无 SVN 菜单、或报错 Cannot run program 'svn'。
确认系统里真有可用的 svn 命令
WebStorm 不会帮你装 SVN，只负责调用。常见错误是只装了 TortoiseSVN 图形界面，但安装时漏选 “Command line client tools”。
- 打开终端（macOS/Linux）或命令提示符（Windows），执行
svn --version；如果返回版本号（如svn, version 1.14.3），说明可用 - 若提示
command not found或'svn' is not recognized，说明命令未安装，或路径没进$PATH - macOS 用户注意：Xcode 自带的
svn（常为 1.9.x）与新版 WebStorm 兼容性差，建议用brew install svn装较新版本，并确认/usr/local/bin/svn存在且可执行 - Windows 用户检查 TortoiseSVN 安装路径，典型位置是
C:\Program Files\TortoiseSVN\bin\svn.exe；路径含空格时 WebStorm 可识别，无需引号
在 WebStorm 设置里填对 svn 可执行文件路径
路径配置错是最多见的失败原因。新版 WebStorm（2020.3+）已内置 Subversion 支持，无需额外插件，但必须手动指定命令行路径。
- 打开
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（除非你明确需要复用全局~/.subversion配置） - 点
Test按钮验证；失败就检查路径拼写、文件权限、是否被杀毒软件拦截
项目根目录必须启用 Subversion 版本控制集成
即使 svn 路径完全正确，右键菜单仍不显示 SVN 项？大概率是项目没启用版本控制集成——这不是自动发生的，必须手动触发。
- 在项目根目录右键 → 若无 SVN 菜单，先点顶部菜单
VCS → Enable Version Control Integration… - 弹出窗口中，下拉选择
Subversion（不是 Git，也不是留空） - 确认后，项目根目录图标会变色（如加 SVN 图标），文件状态才开始生效：蓝色 = modified，绿色 = added，红色 = missing
- 若之前用过 Git，WebStorm 可能缓存了 VCS 类型，此时需先
VCS → Import into Version Control → Create Git Repository删除 Git 标记，再重新启用 Subversion
执行 Checkout 连接远程仓库
这一步才是真正“连接远程 SVN 仓库”的操作，前面三步都是前提准备。它等价于命令行的 svn checkout <URL>。
- 点击顶部菜单
VCS → Checkout from Version Control → Subversion - 在弹出对话框中，点击
+添加远程仓库 URL（格式如https://svn.example.com/repo/trunk） - 选中该 URL，点击
Checkout，选择本地目标文件夹（建议为空目录） - 首次连接会弹窗要求输入用户名和密码；勾选
Save authentication（否则每次操作都要输） - 成功后，项目文件左侧会出现 SVN 状态图标，
VCS → Subversion菜单也会展开完整功能
容易被忽略的是：修改 SVN 地址不能只改设置里的 URL，必须先删掉项目下的 .svn 文件夹（隐藏），再重新 Checkout；否则 WebStorm 仍会沿用旧地址做操作，导致提交失败或指向错误仓库。
