vscode的svn插件依赖系统svn命令，需确保其在path中或通过svn.path配置；必须打开svn工作副本根目录（含.svn文件夹）才能激活功能；提交前需用svn upgrade升级旧工作副本；svn:ignore仅对未追踪文件生效，已add文件须先svn delete --keep-local再忽略。
VSCode里装SVN插件后没反应？检查svn命令是否在PATH中
VSCode的SVN插件（如 johnstoncode.svn-scm）本身不带SVN二进制，完全依赖系统已安装的svn命令。如果插件图标灰掉、右键无SVN菜单、状态栏不显示分支信息，大概率是VSCode根本找不到svn。
验证方法：打开VSCode内置终端（Ctrl+`），执行which svn（macOS/Linux）或where svn（Windows）。返回空说明未配置PATH。
- macOS/Linux：把
svn所在路径（如/usr/local/bin或/opt/homebrew/bin）加到~/.zshrc或~/.bash_profile的PATH中，然后重启VSCode（不是重开窗口，是彻底退出再启动） - Windows：确认TortoiseSVN或SlikSVN安装时勾选了“Add command line client tools”，或手动把
bin目录（如C:\Program Files\TortoiseSVN\bin）加入系统环境变量PATH - VSCode设置里可硬编码路径：搜索
svn.path，填入绝对路径，例如"svn.path": "/usr/local/bin/svn"
右键菜单看不到“SVN Commit”？确认工作区根目录是SVN检出目录
VSCode的SVN插件只在“当前打开文件夹是SVN工作副本（working copy）根目录”时才激活全部功能。如果你打开的是子文件夹（比如只打开了src/），插件会静默失效——状态栏不显示trunk、右键无提交选项、资源管理器里不显示✓或!图标。
典型错误场景：用svn checkout https://xxx/trunk myproj拉下来，却在VSCode里打开的是myproj/src这个子目录。
- 正确做法：在VSCode中通过
File → Open Folder…，选择整个myproj文件夹（即包含.svn子目录的那层） - 快速验证：在资源管理器顶部，看是否出现“SOURCE CONTROL”面板且提供“SVN”作为源码管理器；或者执行
Ctrl+Shift+P，搜SVN: Show Log，能弹出日志说明识别成功 - 注意：
.svn是隐藏目录，别误删；Windows资源管理器默认不显示，需开启“显示隐藏的项目”
提交时提示“Working copy is too old”？升级工作副本格式
较新版本的svn客户端（如1.14+）默认创建或升级工作副本为FSX格式，而旧版客户端（如1.9）无法读取，报错Working copy format is too old或E155036: Working copy is too old。这不是VSCode的问题，是SVN版本不兼容。
本质是.svn/wc.db数据库结构变了，老客户端不认识新字段。
- 临时绕过：降级VSCode插件使用的
svn命令版本（不推荐，有安全风险） - 推荐方案：在终端进入工作副本根目录，运行
svn upgrade——该命令会就地升级.svn结构，兼容当前客户端 - 预防措施：团队统一SVN客户端版本；避免混用TortoiseSVN 1.12和命令行svn 1.14+
- 注意：
svn upgrade不可逆，且不会改变你的代码或提交历史
忽略文件不生效？svn:ignore和.gitignore逻辑完全不同
VSCode里右键文件选“SVN: Add to svn:ignore”看似和Git一样，但SVN的忽略规则只作用于**未纳入版本控制的文件**。一旦文件已被svn add过，svn:ignore完全无效——这是最常被踩的坑。
比如你误把node_modules/加入了版本库，之后再设svn:ignore，它依然会出现在待提交列表里。
- 正确流程：先
svn delete --keep-local node_modules（从版本库移除但保留本地），再右键设ignore -
svn:ignore值是相对路径，支持通配符*和**，但不支持!xxx反向排除（SVN没有“否定规则”） - 全局忽略（如
*.log）应设在~/.subversion/config的global-ignores段，而非项目级 - VSCode插件里的ignore操作本质是执行
svn propset svn:ignore "xxx" .，可随时在终端用svn proplist -v核对
SVN没有“暂存区”概念，也没有“忽略已追踪文件”的快捷方式，所有忽略必须在文件未add前完成，这点和Git思维惯性冲突最大。
