webstorm 的 svn 功能需同时满足三条件：本地 svn 命令可用、设置中填对路径并测试通过、项目手动启用 subversion 集成；缺一即导致右键无菜单、checkout 报错、commit 灰显。
WebStorm 的 SVN 功能根本不会自动生效，必须三步全对：本地 svn 命令可用、WebStorm 设置里填对路径、项目手动启用 Subversion 集成。缺一不可，否则右键没菜单、Checkout 报错、Commit 灰掉都是必然结果。
验证本地 svn 命令是否真能用
WebStorm 不自带 SVN 客户端，只调用你系统里的 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），兼容性差，建议brew install svn，路径通常是/usr/local/bin/svn
在 WebStorm 设置里填对 svn 路径并测试
路径写错是第二高频失败原因。新版 WebStorm（2020.3+）已内置支持，但必须手动指定可执行文件位置，且不能靠猜。
- Settings → Version Control → Subversion
- 勾选
Use command line client，在输入框中填完整路径：/usr/local/bin/svn（macOS）或C:\Program Files\TortoiseSVN\bin\svn.exe（Windows） - 路径含空格没问题，WebStorm 能识别，不用加引号；但反斜杠方向别混用（
\或/任选其一即可） - 务必点
Test按钮——失败就立刻检查：拼写、权限、杀毒软件是否拦截、路径下是否存在该文件 - 取消勾选
Use default SVN configuration directory，除非你明确需要复用~/.subversion
项目根目录必须手动启用 Subversion 集成
即使 svn 路径完全正确，右键仍无 SVN 菜单？这不是配置问题，而是项目压根没“接入” SVN。WebStorm 不会扫描 .svn 文件夹自动关联。
- 顶部菜单 VCS →
Enable Version Control Integration… - 下拉框中**明确选择
Subversion**（不是 Git，也不是留空） - 启用后，项目根目录图标会变色（如浅蓝边框），文件名旁出现颜色标记：绿色 = added，蓝色 = modified，红色 = missing
- 如果之前误启用了 Git，需先 VCS →
Disable Version Control Integration，再重新启用 Subversion - 注意：仅靠命令行
svn checkout拉下来的代码，WebStorm 不会自动识别为工作副本——这一步必须人工触发
常见错误现象与对应排查点
报错信息不是随机出现的，每种都指向特定环节。直接看现象，反向定位哪一环断了。
-
Cannot run program 'svn'→ 第一步没过：终端svn --version必定失败，重查安装和 PATH - 右键无 SVN 菜单 → 第三步没做：项目未启用 Subversion 集成，VCS → Enable 才是解法
- Checkout 按钮灰掉 / 提示
Subversion command line client version is too old→ 第二步路径指向了旧版客户端（如 1.5.x），换用 SlikSVN 1.8+ 或 brew 安装新版 -
svn: warning: '.' is not a working copy→ 当前目录不是通过svn checkout初始化的合法工作副本，不能直接 Commit；应先用 VCS →Import into Version Control → Subversion关联远程 URL
最容易被忽略的是：WebStorm 对 SVN 的支持完全依赖外部命令行工具，它自己不解析 .svn 元数据，也不缓存仓库状态。只要 svn 命令调不通，或者项目没走那一步 Enable Version Control Integration，所有功能都会静默失效——没有中间状态，只有全有或全无。
