webstorm 找不到 svn 命令行可执行文件，需先验证终端运行 svn --version 是否成功；若失败，tortoisesvn 用户须重装并勾选“command line client tools”，windows 路径填 c:\program files\tortoisesvn\bin\svn.exe，macos 推荐 brew install svn 并填 /usr/local/bin/svn；配置后必须点击 test 验证，并在 vcs → enable version control integration 中手动选择 subversion。
WebStorm 找不到 svn 命令行可执行文件
这是最常卡住的第一步：WebStorm 启动 SVN 功能时直接报错 “Can’t use Subversion command line client”，或者 Checkout/Commit 按钮灰掉。根本原因不是 WebStorm 问题，而是它压根没找到系统里可用的 svn 命令。
验证方式很简单：打开终端（macOS/Linux）或命令提示符（Windows），输入 svn --version。如果返回版本号（如 svn, version 1.14.3），说明命令行客户端已就位；若提示 command not found 或 'svn' is not recognized，就得先装对东西。
- TortoiseSVN 用户必须在安装时勾选 “Command line client tools”（默认不勾），否则只有图形界面，没有
svn.exe - Windows 路径通常为：
C:\Program Files\TortoiseSVN\bin\svn.exe（注意是svn.exe，不是tortoiseplink.exe或tortoiseProc.exe） - macOS 推荐用 Homebrew 安装：
brew install svn，路径一般是/usr/local/bin/svn；Xcode 自带的svn（版本 1.9.x）容易与新版 WebStorm 冲突，不建议直接用 - 路径填进 WebStorm 的
Settings → Version Control → Subversion → Use command line client后，务必点Test按钮验证，失败就检查拼写、空格、反斜杠方向（Windows 用\或/都行，但不能混用）
项目右键无 “Subversion” 菜单项
即使 svn 路径配对了，右键菜单还是看不到 Commit/Update/Revert 等选项——这说明项目本身没“接入” SVN，不是插件或路径的问题，而是少了一步手动启用。
WebStorm 不会自动把整个项目当成 SVN 工作副本，哪怕你已经在本地用命令行 svn checkout 拉过代码。
- 必须手动触发：
VCS → Enable Version Control Integration…，然后从下拉框中明确选择Subversion（不是 Git，也不是留空） - 启用后，项目根目录图标会变色（常见为浅蓝边框），文件名旁出现颜色标记：绿色 = 新增未提交，蓝色 = 已修改，红色 = 缺失或冲突
- 如果之前误启用了 Git，WebStorm 可能缓存了 VCS 类型，此时需先
VCS → Disable Version Control Integration，再重新启用 Subversion
HTTPS 连接报 handshake_failure 或证书校验失败
连接公司内网 SVN（尤其是自签名 HTTPS 证书）时，常见错误：Received fatal alert: handshake_failure 或 Server SSL certificate verification failed。这不是 WebStorm 的 bug，而是 Java 运行时（WebStorm 底层依赖）和 SVN 客户端对 TLS 协议/证书的信任策略不一致。
- 先用命令行测试：
svn ls https://your-svn-url，按提示输入p（永久接受证书），这会把证书写入 SVN 的用户配置目录（如~/.subversion/auth/） - WebStorm 默认复用系统 SVN 配置，但有时 Java 层 SSL 设置会拦截。进入
Settings → Version Control → Subversion → Network，尝试勾选Use non-interactive mode，并手动指定 SSL 协议为TLSv1.2（不要选 SSLv3） - 若仍失败，临时方案是在 WebStorm 启动脚本里加 JVM 参数：
-Dsvnkit.http.sslProtocols=TLSv1.2，但更稳妥的做法是让运维更新服务器证书或启用兼容性更强的协议
提交失败但错误信息模糊（如 “Working copy is too old”）
这类报错往往出现在团队多人协作、SVN 客户端版本不统一的场景。典型提示：E155036: Working copy is too old 或 svn: E175002: Unexpected HTTP status 405，本质是工作副本格式与当前 svn 客户端不匹配。
- WebStorm 自带的 SVNKit（旧版）和外部命令行
svn使用不同工作副本格式；一旦混用（比如先用命令行svn upgrade，再用 WebStorm 提交），极易出错 - 解决优先级：停用 WebStorm 内置 SVNKit，坚持用外部命令行客户端（即勾选
Use command line client并确保路径正确） - 升级工作副本：
svn upgrade必须用和 WebStorm 配置一致的svn版本执行，且需在工作副本根目录运行 - 极端情况可删掉
.svn目录重新svn checkout，但注意先备份未提交的修改
svn 命令行工具的状态、项目级的手动启用动作、以及 HTTPS 场景下 Java 与原生 SVN 对证书/TLS 的双重处理逻辑。最容易被忽略的是：命令行 svn 路径配对 + 项目启用 Subversion + 证书首次信任三者缺一不可。
