离线安装VSCode插件成功的关键是确保.vsix文件的版本、签名、平台三者全对；须通过官方市场“Download Extension”按钮或API直链下载，安装时加--allow-unverified参数、关闭所有VSCode实例、使用纯英文路径，并在联网环境预触发语言服务器后整目录迁移。
离线安装 VSCode 插件，核心不是“怎么点”，而是“怎么确保装进去的那个 .vsix 文件，版本、签名、平台三者全对”。错一个，就会卡在 INVALID_SIGNATURE、Extensions compatibility is not supported 或装完不生效。
怎么拿到真正能用的 .vsix 文件
别信浏览器下载记录里那个自动命名的文件——它可能被重定向成 HTML 错误页，也可能来自第三方镜像（比如 open-vsx.org），和官方市场签名不一致。唯一稳的路径是走微软官方直链：
- 打开插件页，例如
https://marketplace.visualstudio.com/items?itemName=ms-python.python - 点右侧 Resources → Download Extension，这个按钮生成的是带有效期签名的临时 URL，版本、平台、签名三者全对
- 如需历史版本或批量下载，用 API 拼：
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension_name}/{version}/vspackage，其中publisher是 ID 小数点前半段（如ms-python），extension_name是后半段（如python），version必须和 Version History 里完全一致（如2026.6.123456） - 下载后建议重命名，含平台标识，例如
python-2026.6.123456-win32-x64.vsix，避免在 Windows 上误装darwin-arm64版
code --install-extension 总报错？盯住这三点
命令行安装不是“有文件就能跑”，VSCode 对路径、签名、进程状态极其敏感：
-
command not found: code：不是 PATH 问题，而是 VSCode 从未启用 Shell Command。在 VSCode 里按Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车执行 -
INVALID_SIGNATURE：离线环境无法校验微软证书链，必须加--allow-unverified参数，例如：code --install-extension python-2026.6.123456-win32-x64.vsix --allow-unverified - 装完
code --list-extensions不显示，或重启后仍不生效：大概率 VSCode 进程还在后台运行。关掉所有实例（包括系统托盘里的），Windows 下可任务管理器结束所有Code.exe进程 - 路径含中文或空格（如
C:\用户\张三\vsix\python.vsix）会静默失败，务必移到纯英文路径，例如C:\vsix\python.vsix，且 Windows 下推荐用正斜杠：code --install-extension "C:/vsix/python.vsix"
装上了却不工作？语言服务器没初始化是主因
像 ms-python.python、esbenp.prettier-vscode 这类插件，.vsix 只是外壳，首次激活时会联网下载 pyright、prettier 等语言服务二进制。离线环境里，这步直接卡死。
- 解决办法：先在有网环境打开一次该插件（比如打开一个
.py文件触发 Python 扩展），让它把依赖下全；再整目录打包迁移：%USERPROFILE%\.vscode\extensions\ms-python.python-2026.6.123456整个文件夹拷到内网机对应路径 - 或者，提前在联网机上用
code --install-extension安装，再从扩展目录里把已解压的文件夹复制过去，比单纯拷.vsix更可靠 - 注意：扩展目录里每个插件文件夹名含版本号，手动复制时别漏掉这个后缀，否则 VSCode 识别为未安装
最常被忽略的一点：VSIX 文件本质是 ZIP 包，你可以直接改后缀解压开看 package.json 里的 engines.vscode 字段——它声明了最低支持的 VSCode 版本。如果你内网的 VSCode 是 1.85，而 .vsix 要求 1.90，再怎么绕过签名也白搭。
