离线安装vscode插件失败主因是版本错配、签名拒绝、依赖缺失；须严格对齐engines.vscode、加--allow-unverified绕过签名校验、依extensiondependencies字段查全依赖，下载务必用marketplace直链并验证.vsix内package.json。
离线安装 VSCode 插件不是“把 .vsix 文件拖进去就完事”，真正卡住人的，是版本错配、签名拒绝、依赖缺失这三类问题。只要提前对齐 engines.vscode、绕过证书校验、查清 extensionDependencies，90% 的失败都能避免。
怎么下载到真正可用的 .vsix 文件
很多开发者从插件页面点“Download Extension”后发现装不上，根本原因是 URL 被缓存或跳转到了非官方源。必须用带插件 ID 的直链，且不能省略版本号。
- 正确做法：打开
https://marketplace.visualstudio.com/items?itemName=ms-python.python→ 右侧 Resources 区域点击 Download Extension → 浏览器会跳转到形如https://marketplace.visualstudio.com/_apis/public/gallery/publishers/ms-python/vsextensions/python/2024.6.0/vspackage的地址，这个才是带签名的有效直链 - 错误做法：复制 GitHub Release 页面的
python-2024.6.0.vsix链接，它没经过 Marketplace 签名，code --install-extension会报INVALID_SIGNATURE - 第三方镜像（如 OpenVSX）下载的包，
engines.vscode字段可能未更新，务必解压 .vsix 后检查根目录下package.json中的"vscode": "^1.85.0"是否匹配你本地的code --version输出
code --install-extension 报错 INVALID_SIGNATURE 怎么办
这是离线环境最典型的报错，本质是 VSCode 启动时尝试连接微软证书服务验证插件签名，但网络不通导致失败。不是文件损坏，也不是权限问题。
- 唯一有效解法：加
--allow-unverified参数，例如code --install-extension python.vsix --allow-unverified - 注意：该参数只对当前命令生效，不能写进配置；也不影响插件功能，只是跳过签名链校验
- 如果仍失败，先确认
code命令本身可用：在 VSCode 内按Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车执行，否则code命令根本不存在
装完插件不显示、不生效，是不是没装成功
不是。VSCode 的扩展系统分两层：已安装（installed）和已启用（active）。离线环境下，插件可能因缺少依赖被自动禁用，但 code --list-extensions 仍会列出它。
- 验证是否真启用：打开命令面板（
Ctrl+Shift+P）→ 输入Developer: Show Running Extensions→ 查看目标插件状态是否为 “Running” - 常见隐式依赖：比如
esbenp.prettier-vscode必须搭配esbenp.vscode-eslint或bradlc.vscode-tailwindcss才能格式化，这些不会在插件市场页面写明，得看.vsix解压后package.json的extensionDependencies字段 - 装完必须重启 VSCode，否则新插件不会加载；某些插件（如 Remote-SSH）还需手动触发一次连接才能拉起后台服务
批量部署时怎么确保所有依赖都装全
靠人肉记插件名或抄“推荐列表”必然漏掉。真实依赖树藏在每个 .vsix 的元数据里，不是市场页面上写的“Also installed by”。
- 最稳路径：在一台已联网、已配好的机器上，运行
code --list-extensions > extensions.txt，得到完整 ID 列表 - 然后用
vsce download逐个下载，例如vsce download ms-python.python@2024.6.0，它会自动解析并下载extensionDependencies中声明的所有依赖项 - 切勿直接用
code --install-extension *.vsix通配安装——VSCode 不保证安装顺序，而依赖关系要求父插件必须在子插件之前激活
离线安装真正的复杂点不在操作步骤，而在版本对齐的不可见性：engines.vscode、engines.node、extensionDependencies 这三项必须全部满足，缺一不可。任何一项不匹配，都不会报明确错误，只会表现为“装了但不动”。建议把每次下载的 .vsix 解压后第一件事就是打开 package.json 对照检查。
