VSCode使用SVN需确保系统svn命令可用且版本兼容（推荐1.8.x）、工作区为含.svn的根目录、插件路径显式配置正确；否则将出现“未找到SVN”或提交无响应。
VSCode 本身不带 SVN 支持，装了插件也不代表能用——核心卡点永远是 svn 命令行工具是否被正确找到、版本是否兼容、工作区是否在正确路径下。跳过验证直接配，90% 会卡在“未找到 SVN”或提交后无响应。
确认本地 svn 命令可用且版本匹配
旧项目往往绑定 SVN 1.6–1.8，而 macOS 自带的 svn（1.14+）或新版 TortoiseSVN 的命令行默认不向下兼容。必须先验证终端能否跑通：
- 运行
svn --version，输出必须是1.8.x（常见于 SlikSVN 1.8 或 CollabNet 1.8） - 若输出是
1.14.2或更高，说明系统默认 svn 不可用，得单独下载 SlikSVN 1.8 并手动指定路径 - Windows 用户注意：TortoiseSVN 默认不把
svn.exe加入 PATH，安装时必须勾选 “Command line client tools” - macOS 用户避免用
brew install subversion装最新版；应从 archive.apache.org 找 1.8.x 的二进制包
手动配置 svn.executablePath，别信自动发现
VSCode 的 SVN 插件（如 johnstoncode.svn-scm）不会 fallback 到 PATH 查找，也不会自动识别多个版本中的旧版。必须显式写死路径：
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Preferences: Open Settings (JSON) - 添加字段：
"svn.executablePath": "/usr/local/svn18/bin/svn"（macOS）或"svn.executablePath": "C:\Program Files\SlikSVN\bin\svn.exe"（Windows，反斜杠双写或改用正斜杠） - 路径中禁止含中文、空格、波浪号
~；否则插件 spawn 失败，控制台报spawn ENOENT - 改完必须重启 VSCode——不重启，插件仍缓存旧路径
打开项目必须是 .svn 所在的根目录
插件只在工作区根目录下存在 .svn 文件夹时才激活，不递归扫描，也不支持子目录打开：
- 错误做法：只打开
project/src/，但.svn在上层project/→ 插件完全不响应 - 正确做法：用 VSCode 直接打开含
.svn的那一层目录（比如project/） - 右键菜单没 SVN 选项？先检查资源管理器里该目录下是否真有
.svn文件夹（不是.git混着） - Windows 下若
.svn在C:Program Files等受保护路径，非管理员启动的 VSCode 可能读不到元数据
首次检出别用 VSCode 右键菜单
VSCode 插件对 svn checkout 支持极弱，容易卡住或生成损坏工作副本：
- 务必先在终端执行：
svn checkout <URL>，确保.svn完整生成 - 再用 VSCode 打开该目录——不要用插件里的 “SVN > 检出”
- 如果服务端用
svn://或老式http://（非 HTTPS），终端先测试：svn info <URL>，看是否报RA layer request failed或SSL handshake failed - 遇到 SSL 错误，SlikSVN 1.8 可设环境变量
SSLVersion=TLSv1，或临时改用http://URL（如果服务端允许）
最易被忽略的是：VSCode 插件不读取 ~/.subversion/server 配置，所以代理、证书信任、忽略规则等都得先在终端验证通过，再进 VSCode。一旦状态栏没显示分支名，别急着重装插件——先查 svn.info 输出、路径、权限、版本四件事。
