离线安装VSCode插件的核心卡点是.vsix文件有效性、code命令可用性及依赖完整性；必须通过官方页面下载或API拼URL获取带签名的正确版本，用--allow-unverified参数安装，并手动校验extensionDependencies字段确保依赖齐备。
离线环境下装 VSCode 插件，核心卡点不在“怎么点”，而在于 .vsix 文件是否真正可用、code 命令能否执行、以及依赖是否被静默忽略——三者任一出错，插件就只是“显示已安装”，实际功能全失效。
怎么下载到真正能用的 .vsix 文件
别信第三方打包站，也别从 GitHub Release 页面随便下；很多开源插件的 Release 页没同步最新 .vsix，engines.vscode 字段可能还是旧的，导致安装后直接不加载。
- 最稳方式：打开插件页面（如
https://marketplace.visualstudio.com/items?itemName=ms-python.python），右侧 Resources 区域点Download Extension—— 这个按钮生成的是带签名的临时直链，版本和签名都对得上 - 批量或下旧版本？用官方 API 拼 URL：
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension_name}/{version}/vspackage，其中publisher是ms-python，extension_name是python（小数点后半段），version必须和 Version History 里完全一致，比如2026.6.123456 - 下载后建议重命名，加上版本号，如
python-2026.6.123456.vsix，避免后续混淆
code --install-extension 总是报错？先查这三件事
code --install-extension 报错信息极简，但实际原因很具体：
-
command not found: code→ 不是 PATH 问题，而是 VSCode 没启用 Shell Command：按Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车执行 -
INVALID_SIGNATURE→ 离线环境无法校验证书链，必须加--allow-unverified参数：code --install-extension python.vsix --allow-unverified - 装完没反应、
code --list-extensions也不显示 → 很可能是 VSCode 正在运行且已加载同名插件，先关掉所有 VSCode 实例再重试 - 路径含中文或空格（如
C:\用户\张三\下载\python.vsix）→ 移到纯英文路径，例如C:\vsix\python.vsix
插件装了但功能不生效？大概率缺依赖
VSCode 插件的依赖关系不是靠“推荐列表”决定的，而是硬编码在 .vsix 解压后的 package.json 的 extensionDependencies 字段里。比如装了 esbenp.prettier-vscode 却没装 bradlc.vscode-tailwindcss，格式化 Tailwind 类名就会静默失效。
- 手动检查方法：用 ZIP 工具打开
.vsix文件，查看根目录下package.json中的extensionDependencies字段 - 依赖插件也得走同样流程下载
.vsix并安装，顺序无关，但缺一不可 - 某些插件（如 Remote-SSH、WSL）还依赖系统级组件，离线部署前需确认目标机器已预装对应运行时
真正容易被忽略的是：插件签名验证失败时，GUI 方式（从 VSIX 安装）默认会静默跳过验证，而命令行不加 --allow-unverified 就直接中断；但即使 GUI 成功“安装”，部分插件也会因签名缺失拒绝激活——所以离线环境务必统一用命令行 + 显式参数，才可控。
