真正能用的.vsix文件必须通过官方市场页“Download Extension”按钮下载或用API拼URL（含准确publisher、extension_name和version）；离线安装需加--allow-unverified参数、关闭所有VSCode实例、确保VSCode版本与插件engines.vscode严格匹配，并在联网机预触发LSP后整目录迁移。
VSCode 本身没有“离线安装包”这个概念——你下载的 VSCode.exe、VSCode.app 或 .deb 文件就是离线安装包，直接运行即可；但很多人真正想问的是：如何下载 **插件** 的离线包（.vsix）并确保它在内网或断网机器上真正生效。
怎么拿到真正能用的 .vsix 文件
90% 的失败源于文件本身不匹配：签名过期、平台错位、版本越界。别从 GitHub 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-darwin-arm64.vsix，避免在 M 系列 Mac 上误装 x64 版 - Windows 下路径含中文或空格（如
C:\用户\张三\vsix\python.vsix）会静默失败，务必移到纯英文路径，例如C:\vsix\python.vsix
code --install-extension 总报错？先盯住这三点
这个命令容错极低，报错信息又极简，实际卡点非常具体：
-
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.vsix --allow-unverified - 装完
code --list-extensions不显示，或重启后仍不生效 → 很可能是 VSCode 正在运行且已加载同名插件，先关掉所有实例（包括系统托盘里的进程），Windows 可用任务管理器结束全部Code.exe
装上了却没功能？语言服务器根本没落地
像 ms-python.python、volarjs.volar 这类插件，.vsix 只是注册前端，首次启用才下载 LSP 服务（pyright-server、volar-server）。离线环境卡在 “Downloading…” 就是这个原因。
- 正确做法：在有网机器上完整触发一次——打开一个
.py或.vue文件，等状态栏显示 “Ready”，然后把整个~/.vscode/extensions/ms-python.python-2026.6.0/目录（含子目录里的 native 二进制）拷到内网机对应路径下 - 复制完必须彻底退出 VSCode，包括右下角托盘进程，否则缓存不刷新
- 最常被忽略的一点：
VSCode主版本号和插件package.json中的engines.vscode字段必须严格匹配。比如插件要求"^1.85.0"，而你本地是1.84.2，就必然失败
真正难的不是下载或安装，而是确认语言服务器、native 二进制、用户配置（settings.json）、甚至组策略是否允许扩展——这些环节任何一个断掉，插件都只是“挂着”，不是“跑着”。
