WebStorm SVN 集成需三步：安装命令行 svn 工具并验证可用、在设置中正确填写路径、手动启用项目级 Subversion 集成；缺一即导致功能失效。
WebStorm 本身不带 SVN 客户端，必须先装对命令行工具、填对路径、再手动启用项目级集成，三者缺一不可；否则右键没 SVN 菜单、Checkout 按钮灰掉、或报 “Cannot run program 'svn'”。
确认本地 svn 命令可用
WebStorm 所有 SVN 功能（checkout、commit、update）都靠调用系统里的 svn 可执行文件。它不会帮你安装，也不会用 TortoiseSVN 的图形界面程序代替。
- 打开终端（macOS/Linux）或命令提示符（Windows），运行
svn --version - 如果返回类似
svn, version 1.14.3，说明已就位；若提示command not found或'svn' is not recognized，就得重装 - TortoiseSVN 用户：重装时务必勾选 “Command line client tools”（默认不选），路径通常是
C:\Program Files\TortoiseSVN\bin\svn.exe - macOS 用户：Xcode 自带的
svn（常为 1.9.x）与新版 WebStorm 兼容差，建议用brew install svn，然后确认/usr/local/bin/svn存在且可执行 - Windows 路径含空格（如
C:\Program Files\...）没问题，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——这步不会自动发生，必须手动触发。
- 在项目根目录右键 → 若无 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 From Version Control
项目已启用 Subversion 后，才能从远程仓库拉代码；直接拖文件夹或复制粘贴进项目不会自动关联 SVN。
- 确保项目根目录已启用 Subversion（上一步已完成）
- 点顶部菜单
VCS→Checkout From Version Control→Subversion - 点击
+添加仓库地址，粘贴你的 SVN URL（如https://svn.example.com/repo/project） - 选中该地址，点
Checkout，选择本地目标路径（建议为空文件夹） - 首次连接会弹出认证框，输入用户名密码；成功后，项目文件自动下载，状态图标实时更新
最容易被忽略的是「项目级启用」这一步——很多人卡在右键没菜单，反复检查路径却忘了去 VCS → Enable Version Control Integration 点一下。另外，Test 按钮不是摆设，它真能帮你快速定位路径或权限问题。
