多根工作区中插件行为不一致，需通过.vscode/extensions.json显式声明recommendations和unwantedRecommendations实现按子项目隔离；插件未生效常因路径未匹配激活事件或被unwantedRecommendations拦截。
多根工作区里插件行为不一致？先看 extensions.json 是否启用隔离
VSCode 插件在多根工作区中默认是全局生效的，但很多插件（比如 ESLint、Prettier、TypeScript）会根据当前打开的文件路径自动切换配置——这背后依赖的是工作区级的启用控制。如果你发现前端代码没触发格式化，而后端却报 ESLint 错误，大概率是插件没被正确“分配”到对应根目录。
解决方法很简单：在工作区根目录下创建 .vscode/extensions.json，用 recommendations 和 unwantedRecommendations 显式声明每个子项目的插件需求：
-
"recommendations"列表只写该子项目真正需要的插件 ID（如esbenp.prettier-vscode），避免后端项目加载前端专用插件 - 对跨项目通用插件（如
ms-python.python），可放在 workspace 级settings.json中统一启用，但不要放进extensions.json - 若某插件在某个子项目里完全不工作，检查它是否被
unwantedRecommendations拦截，或是否因路径未匹配激活事件（如onLanguage:typescript）而根本没启动
directory-tree 生成的结构总缺关键文件？注意 files.exclude 和 search.exclude
插件 directory-tree 或 Project Tree 默认只遍历 VSCode 当前索引到的文件，而不会读取磁盘全量内容。如果你发现生成的目录里没有 .vscode、node_modules 下的子模块，甚至漏掉 dist/，不是插件坏了，而是 VSCode 主动过滤了它们。
关键点在于两个排除配置项的作用范围不同：
-
files.exclude控制资源管理器（侧边栏）是否显示文件，directory-tree会尊重它——所以想让.vscode出现在目录树里，得在对应子项目的.vscode/settings.json中设"files.exclude": { ".vscode": false } -
search.exclude影响搜索和插件扫描范围，但directory-tree不读它；不过像Markdown All in One的 TOC 生成会受其影响 - 某些插件（如
file-desc）依赖DirectoryV2.json记录元信息，如果该文件被files.exclude隐藏，右键菜单就无法识别上下文
自定义插件读不到项目根目录下的 DirectoryV2.json？检查 activationEvents 范围
像 file-desc 这类为目录添加描述的插件，核心逻辑是监听右键点击并读写项目根目录的 DirectoryV2.json。但如果插件装完没反应，90% 是因为 package.json 里 activationEvents 写窄了。
常见错误写法："onCommand:vsplugin.fileDescJson" 只在命令调用时激活，但右键菜单触发属于 onView 或 onCustomEditor 场景；更稳妥的方式是同时声明：
-
"onStartupFinished"确保插件启动后立即注册上下文菜单 -
"onUriScheme:file"覆盖本地文件系统路径 -
"onLanguage:json"让插件能解析并编辑DirectoryV2.json
另外，插件内读取 DirectoryV2.json 时别硬编码路径，要用 vscode.workspace.workspaceFolders[0]?.uri.fsPath 获取第一个工作区根路径，否则在多根工作区里可能读错目录。
插件路径冲突导致扩展失效？优先用 --extensions-dir 隔离测试环境
开发或调试插件时，如果本地已安装同名插件（比如你正在改 file-desc，但市场版也叫 file-desc），VSCode 会加载旧版本，且不提示冲突——现象就是断点不命中、console.log 不输出、右键菜单消失。
最干净的隔离方式不是卸载原插件，而是启动 VSCode 时指定独立插件目录：
- 终端执行：
code --extensions-dir /tmp/vscode-test-extensions --user-data-dir /tmp/vscode-test-user - 这样所有插件（包括你正在调试的）都从干净目录加载，避免缓存污染和版本覆盖
- 配合
launch.json的runtimeExecutable字段，可一键启动带自定义插件路径的调试实例
记住：VSCode 的插件加载顺序是先扫 --extensions-dir，再 fallback 到默认路径，所以这个参数不是“补充”，而是“替代”。
