应区分插件安装路径、运行时上下文路径和工作区路径，通过vscode.workspace.workspaceFolders获取项目路径并用path模块标准化处理，避免在when表达式中硬编码绝对路径。
VSCode插件路径和本地开发路径不一致怎么办
插件默认装在 ~/.vscode/extensions（macOS/Linux）或 C:Users{User}.vscodeextensions（Windows），但你的项目可能在 D:projects 或 /Volumes/Data/myapp —— 这本身不是错误，只是路径隔离。问题常出现在插件逻辑依赖“当前工作区路径”时，比如右键菜单、文件监听、资源匹配等场景。
关键不是让插件“挪到项目里”，而是让插件行为能正确识别你打开的项目路径。常见误操作是试图把插件目录硬塞进项目根目录，这既不被 VSCode 支持，还会导致插件加载失败。
- 插件无法访问
workspaceFolder以外的路径，除非显式请求权限（如workspace.fsAPI） -
resourceDirname是绝对路径，且 Windows 用\、macOS/Linux 用/，写when表达式时必须适配平台 - 不要在
package.json的when中写死本地绝对路径（如"resourceDirname =~ /D:\\myproject\\src/"），它无法跨机器复用
when 表达式中 resourceDirname 正则匹配要转义斜杠
VSCode 1.80+ 版本起，when 中的正则引擎要求字面量 / 必须双写为 //，否则解析失败——这不是 bug，是语法变更。例如匹配 project/models 目录：
❌ 错误写法："resourceDirname =~ /project/models/"（旧版可运行，新版直接忽略该条件）
✅ 正确写法："resourceDirname =~ /project\/models/"（Windows）或 "resourceDirname =~ /project/models/"（macOS/Linux）
更稳妥的做法是统一用 分隔符并双写："resourceDirname =~ /project\models/"，VSCode 会自动按平台归一化。
- 调试
resourceDirname值：用Developer: Inspect Context Keys，点选目标文件夹，看控制台输出的实际路径格式 - 避免用
resourcePath做路径判断，它包含 URL 编码（如%20），正则易出错 - 若需跨平台兼容，优先用
workspaceFolder+path.relative在插件代码里计算，而非靠when硬匹配
插件开发时如何让路径逻辑适配不同环境
本地开发、CI 构建、code-server 部署时，resourceDirname 可能是绝对路径，也可能是相对于 workspace 的路径——这不是配置错误，而是 VSCode 运行模式差异所致。code-server 默认以 workspace 根为基准，而桌面版始终用绝对路径。
真正可控的是插件自己的逻辑层。建议在激活函数中读取 vscode.workspace.workspaceFolders，再用 Node.js path 模块做标准化处理：
const path = require('path');
const workspaceFolder = vscode.workspace.workspaceFolders?.[0];
if (workspaceFolder) {
const modelsPath = path.join(workspaceFolder.uri.fsPath, 'models');
// 后续用 fs.stat 或 glob 匹配，比 when 更可靠
}
- 不要在
package.json里依赖路径变量，它不支持插值 - 如果必须用
when控制 UI 显示，用explorerResourceIsFolder && viewItem == models这类语义化条件，比路径正则更稳定 - 测试多环境时，手动启动 code-server 并传
--extensions-dir参数，确保插件路径一致
修改插件安装目录不影响开发路径匹配
用 code --extensions-dir "/path/to/ext" 只是把插件二进制文件存哪，跟插件运行时看到的项目路径毫无关系。有人误以为“把插件放项目里就能读到相对路径”，这是对 VSCode 插件沙箱机制的误解。
插件永远运行在独立进程，其文件系统视图由 VSCode 主进程注入，它能看到的只有你授权的 workspace 范围，以及用户主目录下的配置/扩展目录。
- 自定义
--extensions-dir的唯一价值是缓解 C 盘空间压力或实现多版本隔离 - 若插件需要访问特定项目内文件（如
dbt_project.yml），必须用vscode.workspace.findFiles或fs.readFile（需声明workspace.fs权限） - 路径相关逻辑出问题，90% 情况是没区分清楚“插件安装路径”“插件运行时上下文路径”“用户打开的工作区路径”这三个概念
最常被忽略的点：插件里的路径操作几乎从不涉及 .vscode/extensions 目录本身——你写的代码不会去读那个文件夹，它只关心用户打开了什么文件、在哪个 workspace 下、有没有权限访问对应磁盘位置。把注意力从“插件装在哪”转移到“插件能看见什么”，问题就清晰多了。
