离线插件安装难点在于可持续更新、版本追溯与依赖稳定；需通过官方Marketplace下载.vsix、校验engines.vscode兼容性、按extensions.lock锁定版本组合、生成SHA256校验值并禁用自动更新，避免依赖崩坏。
离线插件安装本身不难，难的是让更新可持续、版本可追溯、依赖不崩坏。 直接复制 .vsix 文件到内网机器装上就跑，短期能用，但三个月后你会遇到：新同事装不上、code --install-extension 静默失败、插件突然报“依赖未满足”却查不到日志——这些问题全源于没处理好版本兼容性与依赖链。
怎么下载到真正能用的 .vsix 文件
官网页面右下角的 “Download Extension” 按钮不是总出现。有些插件（比如某些 GitHub 发布的预发布版）会隐藏该按钮，此时必须手动构造下载 URL。
- 打开插件详情页，F12 打开开发者工具，在 Console 粘贴这段脚本（确保已加载页面）：
const id = document.querySelector('#unique-identifier')?.nextElementSibling?.innerText?.split('.') || []; const ver = document.querySelector('#version')?.nextElementSibling?.innerText; if (id.length === 2 && ver) { console.log('https://marketplace.visualstudio.com/_apis/public/gallery/publishers/' + id[0] + '/vsextensions/' + id[1] + '/' + ver + '/vspackage'); } - 复制输出的链接，在浏览器中打开并下载 —— 这个 URL 返回的就是原始
.vsix，和市场后台实际分发的一致 - 别用第三方聚合站或爬虫批量抓取，它们常缓存旧版或漏掉
engines.vscode字段校验
为什么 code --install-extension 有时不报错也不生效
最常见原因是 package.json 里的 engines.vscode 不匹配。VS Code 1.85.1 不认要求 ^1.90.0 的插件，但命令行不会提示，只会跳过安装。
- 先运行
code --version获取目标环境真实版本（注意是三位数字，如1.85.1） - 用
unzip -p your-plugin.vsix package.json | grep engines查看插件声明的最低 VS Code 版本 - 若插件要求
^1.90.0，而你只有1.85.1，就得回退到历史版本 —— 访问https://marketplace.visualstudio.com/items/{publisher}.{name}/versionhistory手动选旧版下载 - Windows 上若提示
command not found: code，别急着重装；检查是否用了 User Installer 版本，其code.cmd默认不在 PATH，应改用绝对路径："C:\Program Files\Microsoft VS Code\bin\code.cmd"
批量更新插件时如何避免“越更新越坏”
企业级维护不是“把所有插件升级到最新”，而是“锁定一组经验证兼容的版本组合”。盲目更新一个插件，可能触发它对另一个插件的隐式依赖升级，导致预览崩溃或调试断点失效。
- 导出当前稳定环境的插件清单：
code --list-extensions --show-versions > extensions.lock（含版本号） - 在联网机上，用脚本按
extensions.lock逐条下载对应.vsix，而不是用vsce download直接拉 latest - 每个
.vsix下载后，用sha256sum或certutil -hashfile（Windows）生成校验值，写入sha256sums.txt，部署前比对 - 禁用自动更新：在离线机注册表中写入
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\VSCode\Update\UpdateMode=none（需管理员权限）
真正的难点不在第一次安装，而在第 N 次更新时能否快速定位是哪个插件的 engines.vscode 字段变了、哪个依赖被悄悄移除了、哪次传输让 .vsix 少了几个字节。把这些判断点变成检查项，而不是靠运气重试，才是离线环境长期可用的底线。
