WebStorm需手动配置本地SVN命令行路径、启用Subversion集成并完成Checkout，三者缺一不可；否则Checkout/Commit/Update等功能失效或右键无SVN菜单。
WebStorm 本身不带 SVN 客户端，所有 SVN 功能（Checkout、Commit、Update）都依赖你本地已安装且可调用的 svn 命令行工具；路径配错、命令不可达、或没启用项目级集成，都会导致右键菜单不出现 SVN 选项，或点击后报错“Cannot run program 'svn'”。
确认系统里真有可用的 svn 命令
WebStorm 不会帮你装 SVN，只负责调用。常见错误是只装了 TortoiseSVN 图形界面，但安装时漏选 “Command line client tools”。
- 打开终端（macOS/Linux）或命令提示符（Windows），执行
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 标记，再重新启用 SVN
Checkout 是使用 SVN 的前提动作
没有 Checkout 过的项目，WebStorm 不认为它是 SVN 工作副本，所有提交、更新操作都不可用，SVN Repositories 工具窗也为空。
- 首次使用：点
VCS → Checkout from Version Control → Subversion - 填入仓库 URL（如
https://svn.example.com/project/trunk），选本地目标路径，点OK - 输入账号密码（若服务器要求）；成功后项目文件夹会带 SVN 状态标记
- 不要试图跳过这步直接
Import本地代码——那只是把代码推上去，不会建立工作副本关系，后续无法Update或Revert - 若
Checkout失败但Test按钮通过，重点查 URL 是否可访问、认证方式是否匹配（Basic / NTLM / SSL 证书）、防火墙是否放行
最容易被忽略的是：路径对了、设置对了、集成也启了，但没 Checkout 就去点 Commit —— 此时 WebStorm 不知道该提交到哪，也不会报明确错误，只是静默失败或弹出空对话框。务必把 Checkout 当作启动 SVN 工作流的第一步，而不是可选项。
