WebStorm的SVN功能完全依赖本地svn命令行，需确保其可执行、支持代理且正确配置路径；项目须手动启用Subversion集成，IDE不自动识别工作区或保存凭据。
WebStorm 的 SVN 网络连接本身不依赖独立“SVN 服务配置”，它完全复用系统级 SVN 客户端的网络行为；真正要配的是两处：本地 svn 命令行能否跑通、以及该命令行是否支持代理（如公司内网场景）。
确认 svn 命令行能正常访问远程仓库
WebStorm 所有 SVN 操作（Checkout/Commit/Update）都调用你本地的 svn 可执行文件，它本身不内置网络栈。如果 svn list https://your-svn-server/repo 在终端失败，WebStorm 一定失败。
- 先在终端运行
svn --version，确认返回有效版本（如1.14.3） - 再试一个真实仓库地址：
svn list --non-interactive --trust-server-cert https://example.com/svn/project—— 这一步绕过交互式证书确认，更贴近 WebStorm 行为 - 若报
SSL handshake failed或connection refused，问题不在 WebStorm，而在你的系统网络或 svn 客户端配置 - macOS 用户尤其注意：Xcode 自带的
svn（常为 1.9.x）默认禁用 TLS 1.2+，易与现代 SVN 服务器握手失败；建议用brew install svn替换
在 WebStorm 中正确设置 SVN 命令行路径
路径填错是右键无 SVN 菜单、所有功能灰掉的最常见原因。WebStorm 不会自动猜路径，也不会从 $PATH 拉取。
- Windows：典型路径是
C:\Program Files\TortoiseSVN\bin\svn.exe（不是tortoiseProc.exe），安装 TortoiseSVN 时必须勾选 Command line client tools - macOS：Homebrew 安装后路径一般是
/usr/local/bin/svn；验证方式：which svn，复制输出结果 - Linux：路径可能是
/usr/bin/svn或/usr/local/bin/svn，用whereis svn或find /usr -name svn 2>/dev/null确认 - 填入 Settings → Version Control → Subversion →
Use command line client后，务必点Test按钮；失败就检查路径中是否有中文、空格未被正确处理（WebStorm 支持含空格路径，无需引号）
公司内网需走 HTTP 代理时，必须配 svn 的 network 配置
WebStorm 的 HTTP Proxy 设置（File → Settings → Appearance & Behavior → System Settings → HTTP Proxy）只影响 IDE 自身更新和部分插件，不影响 svn 命令行。svn 的代理必须单独配在其 network 配置里。
- 打开 Settings → Version Control → Subversion → Network 选项卡
- 取消勾选
Use default SVN configuration directory（否则可能读取旧的 ~/.subversion/config） - 勾选
Use proxy server，填入代理地址和端口；若需认证，勾选Authentication required并填用户名密码 - 关键：这个配置会写入 WebStorm 自动管理的 SVN 配置目录（如
$HOME/.WebStorm2026.2/system/subversion/config），确保其中[global]段落生成了http-proxy-host和http-proxy-port项 - 验证方式：在终端切换到该配置目录，手动运行
svn --config-dir . list https://your-internal-svn/repo，看是否成功
项目根目录没启用 Subversion 集成，右键菜单永远不出现
即使 svn 命令可用、代理也配好，项目右键仍没有 Subversion 子菜单？说明 WebStorm 根本没把这个目录当 SVN 工作区看待——这步不会自动发生。
- 必须手动触发：顶部菜单
VCS → Enable Version Control Integration…，然后从下拉框中明确选择Subversion（不是 Git，不是留空） - 启用后，项目根目录图标左下角会出现小 SVN 图标，文件名旁开始显示颜色标记（绿色=added，蓝色=modified）
- 如果之前误启用了 Git，WebStorm 会缓存 VCS 类型；此时需先
VCS → Disable Version Control Integration，再重新启用 - 注意：仅靠把代码从命令行
svn checkout出来，WebStorm 不会自动识别——必须走上面的启用流程
最容易被忽略的是：WebStorm 的 SVN 功能本质是“命令行包装器”，它不维护独立连接状态，也不缓存凭据。每次操作都调起新进程，所以代理、证书信任、用户认证都得由底层 svn 自己搞定。别在 WebStorm 设置里找“SVN 服务器地址”或“账号密码保存”——那些都不存在。
