vscode的svn插件（如johnstoncode.svn-scm）不自带svn二进制，必须手动配置正确版本（推荐1.8.x）的svn.executablepath路径，且需打开含.svn的根目录、终端验证svn --version及连通性，否则功能失效。
确认系统 svn 命令可用且版本匹配
VSCode 的 SVN 插件（如 johnstoncode.svn-scm）完全不自带 svn 二进制，它只负责调用你本地的 svn 命令。如果终端里跑不通 svn --version，插件必然失效。
旧项目常见绑定 SVN 1.6–1.8 工作副本格式，而 macOS 自带 svn（1.14+）或新版 TortoiseSVN 默认不向下兼容。必须验证输出是 1.8.x —— 不是 1.9、1.14 或更高。
- Windows：TortoiseSVN 安装时务必勾选 “Command line client tools”；否则
where svn返回空 - macOS：别用
brew install subversion，去 archive.apache.org 找 1.8.x 二进制包手动安装 - Linux（如 CentOS 7）：用
yum install subversion18（若仓库有），或编译安装 SlikSVN 1.8
手动配置 svn.executablePath，别信自动发现
插件不会 fallback 到 PATH 查找，也不会在多个版本中选旧版。PATH 里混着 1.14 和 1.8，它大概率调错。必须显式写死路径。
按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），输入 Preferences: Open Settings (JSON)，添加：
"svn.executablePath": "/usr/local/svn18/bin/svn"
或 Windows 下：
"svn.executablePath": "C:/Program Files/SlikSVN/bin/svn.exe"
- 路径中禁止含中文、空格、波浪号
~—— 否则控制台报spawn ENOENT - Windows 反斜杠要双写
\或统一用正斜杠/ - 改完必须彻底退出 VSCode 再重启 —— 缓存不刷新，插件仍用旧路径
打开项目必须是 .svn 所在的根目录
插件只在工作区根目录下存在 .svn 文件夹时才激活，不递归扫描，也不支持子目录打开。开错目录 = 功能全灰。
- 错误做法：用 VSCode 打开
project/src/，但.svn在上层project/→ 插件无响应 - 正确做法：用
File → Open Folder…直接选project/（即含.svn的那一层） - 快速验证：资源管理器顶部出现 SOURCE CONTROL 面板，且左下角状态栏显示
trunk或分支名 - Windows 下若
.svn在C:Program Files等受保护路径，非管理员启动的 VSCode 可能读不到元数据
首次检出和提交前的关键动作
VSCode 插件对 svn checkout 支持极弱，容易卡住或生成损坏工作副本。别图省事点右键菜单。
- 首次检出：终端执行
svn checkout <url> ./myproj</url>，确保.svn完整生成后再用 VSCode 打开myproj - 提交前遇到
Working copy is too old：说明工作副本格式与客户端不匹配，用终端运行svn upgrade升级（仅限 1.7+ 客户端） - 提交失败提示
File is out of date：不是网络问题，是乐观锁冲突 —— 提交前先点状态栏 SVN 图标执行SVN: Update或快捷键Ctrl+Shift+P→SVN: Update - 服务端用
svn://或老式http://？先终端测试svn info <url></url>，若报RA layer request failed或 SSL 错误，需降级 TLS 或改用 http
~/.subversion/config 或 server 文件里的代理、证书忽略等设置。所有环境适配必须先在终端验证通过，再进 VSCode。
