查插件版本需先确认VS Code精确版本（如1.84.2），再比对插件package.json中engines.vscode字段，必须严格匹配；下载须用官方直链并指定targetPlatform，安装时必加--allow-unverified参数，且需补全extensionDependencies声明的依赖插件。
查插件版本：先看 VS Code 版本，再反推兼容的插件版本号
离线安装失败，八成是插件版本和 VS Code 不匹配。不是“越新越好”，而是必须满足 engines.vscode 字段要求。比如你用的是 VS Code 1.84，而某个 Python 插件的 package.json 里写着 "vscode": "^1.85.0"，那它根本装不上。
查自己 VS Code 版本最准的方式是打开命令面板（Ctrl+Shift+P），输入 Help: About，弹出窗口第一行就是完整版本号，例如 1.84.2 —— 注意小数点后不能省略，1.84 和 1.84.2 在插件兼容性判断中是不同值。
- 别信插件页面写的“Latest”或“Recommended”，那是市场推荐逻辑，不是兼容性保证
- 进插件官网页（如
https://marketplace.visualstudio.com/items?itemName=ms-python.python），点右侧Version History，逐个展开看每个版本的Requirements栏，找明确标出支持你 VS Code 版本的那一行 - 更稳妥的做法：下载任意一个 .vsix 后，改后缀为
.zip，解压后打开extension/package.json，直接读engines.vscode字段
下载正确 .vsix：只认官方直链，不碰第三方镜像或 GitHub Release
很多离线安装失败，根源不在内网，而在联网机上就下了错包。GitHub Release 页面、浏览器插件生成的链接、甚至某些“VSIX 下载站”，常返回无签名、平台错位、或已过期的包。
唯一稳的下载方式是拼官方 API 直链：https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension_name}/{version}/vspackage
-
publisher是 ID 小数点前半段（如ms-python.python→ms-python） -
extension_name是小数点后半段（如ms-python.python→python） -
version必须和 Version History 里显示的完全一致（如2026.6.123456，不能写成2026.6） - 加
?targetPlatform=win32-x64或?targetPlatform=linux-x64确保平台匹配，M系列 Mac 要用darwin-arm64
安装时绕过签名校验：离线环境必须加 --allow-unverified
VS Code 在离线状态下无法连接微软证书服务器，所以默认会拒绝安装任何未验证签名的 .vsix —— 即使这个包是从官方市场下载的。报错通常是 INVALID_SIGNATURE，但命令行不会明说原因，只会卡住或静默失败。
解决方法只有一个：强制跳过签名检查。
- 命令行安装必须带参数：
code --install-extension python-2026.6.123456.vsix --allow-unverified - 图形界面安装（扩展面板 → … → Install from VSIX…）也会触发同样校验，一样会失败；没得绕，只能走命令行
- 路径含中文或空格会静默失败，Windows 下建议用正斜杠并加英文引号：
code --install-extension "C:/vsix/python.vsix" --allow-unverified
依赖插件漏装：别信“推荐”，要看 extensionDependencies 字段
装了 esbenp.prettier-vscode 却发现格式化失效？大概率缺了 bradlc.vscode-tailwindcss 或 ms-python.pylance 这类隐式依赖。这些依赖不会出现在市场推荐栏，只藏在 .vsix 解压后的 package.json 的 extensionDependencies 数组里。
- 批量部署前，先在一台配好的联网机器上执行：
code --list-extensions --show-versions > extensions.txt，导出真实生效的完整列表 - 或者解压 .vsix，打开
extension/package.json，手动检查extensionDependencies字段，逐个补全依赖项 - 依赖插件也得按同样规则查版本、下对应 .vsix、加
--allow-unverified安装，顺序无关，但缺一不可
engines.vscode 和 extensionDependencies，它们不出现在安装界面，却决定插件能不能活。 
