WebStorm 检出 SVN 代码需满足三条件：系统安装并配置好 svn 命令行工具、在 Settings → Version Control → Subversion 中正确指定其路径并启用命令行客户端、通过 VCS → Enable Version Control Integration 明确选择 Subversion 启用项目级集成，缺一不可。
WebStorm 无法直接检出 SVN 代码，除非你先完成三件事：系统里有可用的 svn 命令行工具、WebStorm 设置里指对了它的路径、项目已手动启用 Subversion 集成。缺一不可，否则点 “Checkout from Version Control” 会灰掉、报错或根本找不到 Subversion 选项。
确认本地 svn 命令行是否真正可用
WebStorm 不装 SVN，只调用你系统里现成的 svn 可执行文件。很多用户卡在这一步却以为是 WebStorm 配置问题。
- 打开终端（macOS/Linux）或命令提示符（Windows），运行
svn --version - 如果返回类似
svn, version 1.14.3，说明可用；若提示command not found或'svn' is not recognized，说明没装或没进 PATH - Windows 用户装 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存在且可执行
在 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 路径完全正确，右键菜单仍不显示 “Subversion”？大概率是项目没启用版本控制集成——这不是自动发生的。
- 顶部菜单栏点击
VCS → Enable Version Control Integration… - 弹出窗口中，从下拉列表**明确选择
Subversion**（不是 Git，也不是留空） - 确认后，项目根目录图标会变色（如加浅蓝边框），文件状态才开始生效：绿色 = added，蓝色 = modified，红色 = missing
- 如果之前误启用了 Git，WebStorm 会缓存 VCS 类型，此时需先
VCS → Disable Version Control Integration，再重新启用Subversion
执行 Checkout from Version Control 的实际操作
前面三步做完，这一步才能真正点开、填 URL、拉代码。别跳过任何前置步骤，否则只会看到灰掉的菜单或报错 Cannot run program 'svn'。
- 顶部菜单
VCS → Checkout from Version Control → Subversion - 在
URL输入框填入你的仓库地址，例如：https://svn.example.com/repo/trunk - 选择本地保存路径（必须是空目录，不能是已有项目的子目录）
- 点击
Checkout，等待完成；成功后，项目根目录会出现.svn文件夹，文件名旁出现颜色标记 - 首次提交前，确保至少有一个文件被标记为绿色（added）或蓝色（modified），否则
Commit会提示Nothing to commit
最容易被忽略的是：WebStorm 从不自动识别你本地已用命令行 svn checkout 拉下来的目录为 SVN 工作副本——哪怕目录里明明有 .svn。你必须手动触发 Enable Version Control Integration → Subversion，它才开始监听文件状态、提供右键菜单和 Changes 工具窗口。这个“手动启用”动作没有替代方案，也无自动检测机制。
