真正能用的.vsix文件必须通过官方市场页“Download Extension”按钮下载或用API拼URL（含准确publisher、extension_name和version）；离线安装需加--allow-unverified参数、关闭所有VSCode实例、确保VSCode版本与插件engines.vscode严格匹配，并在联网机预触发LSP后整目录迁移。
离线安装 VSCode 插件失败，90% 的问题出在 .vsix 文件本身不匹配或安装方式绕过了校验流程——不是“下不到”，而是“下错了”或“装歪了”。
怎么拿到真正能用的 .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）
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 实例（包括托盘进程）再重试
装上了却没功能？语言服务器根本没落地
很多插件（如 ms-python.python、volarjs.volar）只装 .vsix 只是注册前端，首次启用才下载 LSP 服务（pyright-server、volar-server）。离线环境卡在 “Downloading…” 就是这个原因。
- 正确做法：在有网机器上完整触发一次——打开一个
.py或.vue文件，等状态栏显示 “Ready” - 然后把整个
~/.vscode/extensions/ms-python.python-2024.6.0/目录（含子目录里的native二进制）拷到内网机对应路径下 - 复制完必须彻底退出 VSCode，包括右下角托盘进程，否则缓存不刷新
最常被忽略的一点：VSCode 主版本号和插件 engines.vscode 字段必须严格匹配。VSCode 1.92 不兼容为 1.85 编译的插件，哪怕只差一个小版本，也会硬性拦截，而不是报错提示。
