最稳方式是用官方API拼URL下载.vsix：https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension_name}/{version}/vspackage，需准确提取publisher、extension_name（小数点后半段）和version，避免404或文件损坏。
怎么从 Marketplace 下载正确的 .vsix 文件
不是所有“Download Extension”按钮都可靠，尤其在第三方镜像站或缓存页面上，可能返回 404 或旧版本。必须用官方市场链接，且路径要包含插件 ID 和版本号。
- 正确做法：打开
https://marketplace.visualstudio.com/items?itemName=ms-python.python，在右侧 Resources 区域点击Download Extension—— 这个按钮生成的 URL 是带签名的直链，能确保版本一致 - 错误做法：从 GitHub Release 页面直接下载，除非你手动校验了
package.json中的engines.vscode字段和 SHA256 值；很多开源插件的 Release 页未同步最新.vsix - 版本陷阱：比如
ms-python.python-2024.6.0.vsix可能不兼容 VSCode 1.84，但官网详情页的Requirements栏会明确写 “VS Code >= 1.85”，务必对照检查
code --install-extension 命令失败的常见原因
命令行安装看似简单，但失败时往往只报错一行，根本看不出问题在哪。实际卡点集中在三个地方：路径、签名、依赖。
-
code命令不可用？不是 PATH 问题，而是 VSCode 没启用“Shell Command”：打开 VSCode →Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车执行 - 报错
INVALID_SIGNATURE？离线环境无法验证微软证书链，加参数--allow-unverified：code --install-extension python.vsix --allow-unverified - 装完不生效？插件可能依赖其他扩展（如 Python 插件强依赖
ms-python.pylance），--list-extensions看不到不代表装成功，得重启 VSCode 后再查Developer: Show Running Extensions
批量安装时怎么避免漏掉依赖插件
单个插件手动装没问题，但团队部署时靠人肉下载容易漏掉隐式依赖 —— 比如装了 esbenp.prettier-vscode 却没装 bradlc.vscode-tailwindcss，结果格式化功能直接失效。
- 最稳方式：在已配好的联网机器上导出完整列表：
code --list-extensions > extensions.txt，然后逐行用vsce download下载对应.vsix：vsce download ms-python.python@2024.6.0 - 别信插件页面写的“Recommended”：那是推荐栏，不是依赖树。真实依赖藏在
.vsix解压后的package.json的extensionDependencies字段里 - 企业级场景建议提前建好本地镜像：用
ovsx serve搭一个内网插件源，把所有.vsix和校验值统一托管，后续只需改一行配置就能批量拉取
内网环境下插件更新和版本锁定的实际约束
离线安装不是一劳永逸的事。一旦插件自动更新被触发，VSCode 会尝试联网回源，失败后可能降级或停用功能，比不装还麻烦。
- 必须关两处自动更新：设置里搜
update.mode设为none；扩展面板右上角菜单里选Disable Auto Updating Extensions - 版本锁定靠的是
.vsix文件名本身：比如把python-2024.6.0.vsix改成python.vsix，下次别人复制这个文件重装，就再也分不清是哪个版本 - 最容易被忽略的一点：Remote-SSH 场景下，VSCode Server 也会尝试下载插件服务端组件。如果目标服务器没外网，得提前在
~/.vscode-server/extensions/目录手动放好对应.vsix解压后的文件夹，否则编辑器连语法高亮都会丢
