核心难点是获取正确.vsix文件：需手拼官方直链https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension_name}/{version}/vspackage，严格匹配大小写、identifier后半段及Version History中完整版本号，下载后解压校验package.json中的version和engines.vscode字段，并用--allow-unverified参数安装。
离线安装特定历史版本的插件，核心难点不在“怎么装”，而在于“怎么拿到那个版本的、真正能用的 .vsix 文件”——90% 的失败都卡在这一步，不是命令写错，是文件本身就不对。
怎么拼出官方市场直链下载特定历史版本
Marketplace 页面上点 Version History 只列版本号，不给下载按钮；随便从 GitHub Release 下载的 .vsix 很可能没签名、engines.vscode 字段过新、甚至压根不是 VS Code 官方构建包。唯一稳的路径是手拼微软官方 API 直链：
-
publisher从插件页右上角 “Publisher” 后面取（如ms-python），注意大小写，MS-CEINTL这类语言包必须全大写 -
extension_name是itemName小数点后半段（如ms-python.python→python），不是 GitHub 仓库名 -
version必须一字不差复制 Version History 表格里“Version”列的完整字符串（如2026.8.123456），少一位就 404 - 最终 URL 格式：
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension_name}/{version}/vspackage
拼完直接浏览器访问，下载下来的文件带微软签名、可验证、版本确定——这是离线部署审计和批量交付的前提。
为什么 vsix 文件名和实际内容经常对不上
你下载到的 yzhang.markdown-all-in-one-2.7.0.vsix，不等于它内部 package.json 声明的版本就是 2.7.0，更不保证兼容你的 VS Code。常见错位场景：
- 第三方镜像站或缓存页返回的是旧版 vsix，但文件名被重写成新版本号
- GitHub Release 页上传的是开发快照（pre-release），没走 marketplace 签名流程，
engines.vscode字段可能写的是^1.90.0，而你本地是 1.84.2 - 手动改过文件名（比如删掉日期后缀），但没解压校验
extension/package.json里的version和engines.vscode
建议：下载后立刻把 .vsix 改成 .zip，用任意解压工具打开，直接看 extension/package.json 里两个字段——这才是真实约束条件。
code --install-extension 安装时必须加 --allow-unverified
离线机器无法访问微软证书吊销列表（CRL）或 OCSP 服务器，所以哪怕你下的是正版签名 vsix，VS Code 也会卡在签名验证阶段，报 INVALID_SIGNATURE 错误。这不是文件损坏，也不是命令写错：
- 必须加参数：
code --install-extension python.vsix --allow-unverified - 不加这个参数，命令会卡住或静默失败，VS Code 日志里也只显示模糊错误
- 该参数仅绕过签名检查，不影响插件功能和安全性（vsix 本身未被篡改）
别试图在联网机上先装一次再拷插件目录——扩展 ID 可能冲突，且部分插件（如 Python）依赖动态生成的 server 进程，离线拷目录大概率不生效。
装完不生效？先查依赖，再查加载状态
执行 code --list-extensions 显示插件 ID，不代表它已加载成功。很多插件有硬依赖，比如：
-
ms-python.python强依赖ms-python.pylance，缺一个，Python 解释器选不了，右下角一直提示“Pylance not installed” -
esbenp.prettier-vscode依赖bradlc.vscode-tailwindcss才能格式化 Tailwind 类名 - 依赖关系藏在 vsix 解压后的
package.json的extensionDependencies字段里，不是插件页面写的“Recommended”
正确验证方式：重启 VS Code → Ctrl+Shift+P → 输入 Developer: Show Running Extensions → 查看目标插件是否在“Running”列表中，且状态为 “Active”。否则，得回联网机补全依赖插件的 vsix 并一起拷过去。
