唯一可靠方式是手拼官方api直链：https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension_name}/{version}/vspackage，三要素必须严格匹配——publisher取右上角id（如ms-python），extension_name取unique identifier小数点后半段（如python），version从version history完整复制（如2026.8.123456），缺一即404。
怎么拿到指定版本的 .vsix 文件
官网页面上“Version History”只列版本号，不提供下载按钮——这是微软有意为之，并非你操作失误。唯一可靠路径是手拼官方 API 直链：https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension_name}/{version}/vspackage。
三个字段必须一字不差：
-
publisher：插件页右上角 “Publisher” 后的 ID（如ms-python），不是 GitHub 用户名 -
extension_name：看 “Unique Identifier”，取小数点后半段（ms-python.python→python） -
version：从 Version History 表格里复制完整字符串（如2026.8.123456），少一位或加latest都会 404
拼好 URL 粘贴到浏览器访问，直接下载带签名的 .vsix。别信 GitHub Release 页面的链接——它常滞后、缺签名，离线安装必报 INVALID_SIGNATURE。
code --install-extension 报错 INVALID_SIGNATURE 怎么办
这不是文件损坏，是 VSCode 在离线环境下无法访问微软证书吊销列表（CRL/OCSP），校验自然失败。绕过方式只有一种：必须加 --allow-unverified 参数。
命令示例：
code --install-extension python-2026.8.123456.vsix --allow-unverified
注意：code 命令本身要能执行——如果提示 command not found: code，不是 PATH 问题，而是 VSCode 从未启用 Shell Command：在 VSCode 里按 Ctrl+Shift+P → 输入 Shell Command: Install 'code' command in PATH → 回车执行。
装上了却没功能？语言服务器根本没落地
很多插件（如 ms-python.python、volarjs.volar）只装 .vsix 是注册前端界面，真正干活的 LSP 服务（pyright-server、volar-server）是在首次打开对应文件时才联网下载的。
离线环境卡在 “Downloading…” 就是这个原因。正确做法：
- 在有网机器上，用目标 VSCode 版本打开一个
.py或.vue文件，等状态栏显示Ready - 找到对应扩展目录，例如
~/.vscode/extensions/ms-python.python-2026.8.123456/（含子目录里的 native 二进制） - 整目录拷到内网机相同路径下，**必须彻底退出 VSCode（包括托盘进程）再启动**
否则缓存不刷新，LSP 还是空的。
最容易被忽略的兼容性陷阱
VSCode 主版本号和插件 engines.vscode 字段必须严格匹配。比如插件 package.json 里写 "vscode": "^1.85.0"，你本地 code --version 输出 1.84.3 就会静默失败，连 code --list-extensions 都不显示。
验证方法：
- 解压 .vsix：
unzip -p python.vsix extension/package.json | grep engines - 查本地 VSCode 架构：
code --version后看 Help → About 括号里的arm64或x64，确保 .vsix 名称或内部构建标识匹配（如darwin-arm64） - 路径含中文或空格会静默失败，Windows 下务必用正斜杠 + 双引号：
code --install-extension "C:/vsix/python.vsix"
版本、签名、LSP、架构——四者缺一不可。漏掉任何一个，看起来像“装成功了”，实际只是个空壳。
