code --install-extension 命令触发vscode完整插件注册流程：校验签名、解析package.json、检查engines.vscode与node兼容性、验证依赖插件，最后解压到扩展目录并注册激活状态。
vscode --install-extension 命令到底做了什么
它不是简单解压文件，而是触发 VSCode 的完整插件注册流程：校验 .vsix 签名、提取 package.json、检查 engines.vscode 兼容性、验证依赖插件是否已安装，最后才解压到扩展目录并写入激活状态。如果其中任一环节失败，命令会静默退出或报错但不提示具体原因。
常见错误现象包括：
-
Extension 'xxx' is not compatible with Code '1.82.2'——engines.vscode字段不匹配 - 命令执行后无反应、插件未出现在扩展列表 —— 签名验证失败或
package.json缺失/损坏 - 插件图标显示灰色、功能不可用 —— 依赖插件未预装（如
ms-python.python依赖ms-toolsai.jupyter）
离线安装必须核对的三个版本字段
打开下载好的 .vsix 文件（本质是 ZIP 包），解压后查看根目录下的 package.json，重点关注以下三项：
-
engines.vscode：必须与目标机器的code --version输出完全兼容。例如"^1.75.0"表示支持 1.75.x 且仅限该主次版本，1.82.2不满足条件 -
engines.node：VSCode 内置 Node.js 版本需落在该区间内。2026 年主流 VSCode 捆绑的是 Node 18.x，若插件要求>=20.0.0就会加载失败 -
dependencies（如有）：列出的其他插件 ID（如"ms-toolsai.jupyter": "^2023.9.100"）必须提前手动安装，否则主插件无法激活
extensions-dir 路径不等于插件实际存放位置
使用 code --extensions-dir /path/to/ext 启动时，VSCode 会把插件解压到该路径下，但后续所有插件管理操作（包括 --install-extension）仍默认写入用户级默认路径，除非你显式指定环境变量或每次启动都带参数。
真正生效的方式只有两种：
- 始终用
code --extensions-dir /path/to/ext --install-extension xxx.vsix组合命令 - 设置环境变量
VSCODE_EXTENSIONS（Linux/macOS）或VSCODE_EXTENSIONS（Windows），再运行code --install-extension
容易忽略的一点：VSCode 启动后，即使你改了 --extensions-dir，已加载的插件不会自动迁移，旧目录里的插件也不会被卸载 —— 必须手动清理。
为什么 Developer: Open Extensions Folder 打开的不是你想要的目录
这个命令只打开当前 VSCode 实例所识别的「活跃扩展目录」，它由启动时的 --extensions-dir 或环境变量决定，而不是操作系统默认路径。如果你用桌面快捷方式启动 VSCode（没带参数），它就打开 ~/.vscode/extensions；如果你用脚本带参数启动，它就打开你指定的路径。
验证方式最直接：
- 在终端中运行
code --extensions-dir /tmp/test-ext --status，然后看输出里Extensions directory:那一行 - 或者打开开发者工具（
Ctrl+Shift+I），在 Console 中执行require('vs/platform/environment/node/environmentService').getExtensionsPath()
离线部署时，别只依赖图形界面看到的路径 —— 它可能和你脚本里写的路径不是同一个。
