跨平台工作区禁用不能只靠extensions.disabled，因其仅标记禁用状态而不阻止激活事件触发，插件仍可能因文件打开等行为被加载报错；应优先使用unwantedDependencies（VSCode 1.85+）实现启动前排除，并配合系统级配置清理（如remote.WSL.enabled、文件关联等）彻底隔离。
Windows 项目里装了 WSL 相关插件，结果在 macOS 上打开时疯狂报错；macOS 专属插件（比如 native-keybindings）在 Linux 机器上直接崩溃——这不是插件坏了，是它根本不该被加载。
为什么跨平台工作区禁用不能只靠 extensions.disabled
VSCode 的 extensions.disabled 字段在 .vscode/settings.json 中写死插件 ID，但它的行为是“禁用后仍可能被激活”：只要某个文件触发了插件的 activationEvents（比如打开 .wslconfig 文件会唤醒 WSL 插件），它就会拉起进程、报错、卡住语言服务器。更糟的是，这个字段对不同系统的插件没做区分——你在 macOS 上禁用 ms-vscode-remote.remote-wsl，到 Windows 上打开同一项目，它依然不会自动启用。
- 真正起作用的是插件是否“被允许启动”，而不是“是否被标记为禁用”
-
extensions.disabled是用户级语义，不是运行时隔离机制 - 跨平台场景下，你往往需要“在 A 系统禁用，在 B 系统启用”，而它不支持条件判断
用 extensions.json + unwantedDependencies 实现系统感知禁用
VSCode 1.85+ 支持 unwantedDependencies，它在插件加载前就将其排除，比 disabled 更底层。配合 VSCode 内置的 os 变量，你可以让禁用规则随系统自动生效：
在项目根目录新建或编辑 .vscode/extensions.json，填入：
{
"unwantedDependencies": [
"${os} === 'linux' ? 'ms-vscode-remote.remote-wsl' : null",
"${os} === 'win32' ? 'ms-vscode-remote.remote-containers' : null",
"${os} === 'darwin' ? 'ms-vscode.azure-account' : null"
]
}
⚠️ 注意：unwantedDependencies 不支持表达式求值，上面写法无效——VSCode 不解析字符串里的 JS 表达式。真实可用的方式是：
- 为每个目标系统单独维护一份
extensions.json（比如extensions.win32.json），再用脚本按process.platform软链接过去 - 更实际的做法：在
.vscode/settings.json中用系统条件配置项替代插件本身，例如禁用 WSL 插件的实际效果，是关掉它依赖的remote.WSL.enabled和remote.autoForwardPorts - 查插件文档确认它是否暴露了 OS 相关开关，比如
gitlens.advanced.enableWorktreeSupport在非 Git 工作树系统上设为false就能避免初始化失败
哪些插件必须按系统处理？看这三类 ID 模式
识别一个插件是否“系统专属”，不用猜，直接看它的 ID：
-
ms-vscode-remote.remote-wsl→ 带wsl的，只应在 Windows + WSL 环境启用 -
ms-vscode-remote.remote-ssh→ SSH 插件在无ssh命令的系统（如某些 CI 容器）里会反复报错，应禁用 -
ms-vscode.azure-account或ms-vsliveshare.vsliveshare→ 依赖系统级身份认证组件，在 headless Linux 或 Docker 环境中无法弹窗登录，强行加载会导致语言服务挂起
这类插件一旦在错误系统上启动，轻则控制台刷红字，重则阻塞整个 onLanguage:jsonc 激活链——因为 VSCode 默认把远程插件和核心 JSON 支持绑在一起。
禁用后还在报错？重点检查这三处
即使你已把插件加进 unwantedDependencies 或 extensions.disabled，以下配置仍会让它复活：
-
"remote.SSH.path"或"remote.WSL.defaultDistro"这类路径配置存在，会强制拉起对应插件来校验值 -
"files.associations"把*.wslconfig关联到wsl语言模式，而该语言模式的activationEvents会触发remote-wsl -
"editor.defaultFormatter"指向一个已被禁用的跨平台插件 ID（比如esbenp.prettier-vscode），VSCode 会尝试加载它来执行格式化，哪怕它在unwantedDependencies里
最稳的解法不是禁插件，而是删掉所有让它“有理由启动”的线索——包括 settings.json 里的相关字段、文件关联、甚至 .vscode/tasks.json 中调用其命令的 task。
