离线下载 vscode 插件必须使用拼接的官方 api url：https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension_name}/{version}/vspackage，其中 publisher、extension_name 和 version 需严格按插件页标识填写；依赖插件须通过 package.json 中的 extensiondependencies 字段自动递归获取，否则批量部署易因缺失依赖导致功能静默失效。
离线下载 VSCode 插件，核心就一条：必须拿到真实有效的 .vsix 文件，且版本与目标机器的 VSCode 兼容。靠浏览器右键“另存为”或 GitHub Release 页面直接下载，大概率失败——不是 404，就是装不上、签名报错、依赖缺失。
怎么拼出能用的官方 .vsix 下载链接
VS Code Marketplace 所有插件都走统一 API 接口，手动拼 URL 是最稳的方式，避开缓存和权限干扰。
-
publisher：插件页右上角 “Publisher” 后面的 ID，比如ms-python、esbenp，不是用户名或组织名 -
extension_name：看页面下方 “Unique Identifier”，取小数点后半段，例如ms-python.python→ 填python；esbenp.prettier-vscode→ 填prettier-vscode -
version：必须和页面右侧 “Version” 栏完全一致，如2026.8.123456；若需旧版，点 “Version History” 手动选，别抄错一位数字
最终 URL 格式：https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension_name}/{version}/vspackage
示例（Python 插件 2026.8 版）：https://marketplace.visualstudio.com/_apis/public/gallery/publishers/ms-python/vsextensions/python/2026.8.123456/vspackage
为什么“Download Extension”按钮有时点不动或 404
这个按钮只在未安装状态、且登录账号未缓存过该插件时才显示。一旦你或别人装过又卸载，服务端会动态隐藏它——不是浏览器问题，是微软后端策略。
- 临时解法：开无痕窗口 + 完全登出 marketplace 账号，再访问插件页
- 但不解决批量部署需求：你没法靠无痕窗口批量抓 20 个插件的历史版本
- 更糟的是：部分镜像站或第三方聚合页的“Download”按钮，实际跳转的是无效链接，返回 404 或旧包
所以别赌按钮，直接拼 URL 或用命令行工具（如 curl）下载更可控。
code --install-extension 安装失败的三个硬卡点
命令行看似干净，但失败时往往只报 INVALID_SIGNATURE 或静默退出，根本看不出哪错了。
-
code命令不可用？不是 PATH 没配好，而是 VSCode 没启用 Shell Command：按Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车执行 - 报
INVALID_SIGNATURE？内网机器无法校验证书链，必须加--allow-unverified参数：code --install-extension python.vsix --allow-unverified - 装完不生效？
--list-extensions看不到 ≠ 没装上；插件可能因依赖缺失（如 Python 强依赖ms-python.pylance）而被禁用，需重启 VSCode 后进Developer: Show Running Extensions查真实状态
批量离线部署最容易漏掉的坑
单个插件手动下、手动装没问题，但给几十台内网机器部署时，人肉操作必然漏依赖。
比如你下了 esbenp.prettier-vscode，却没同步下 bradlc.vscode-tailwindcss（Tailwind IntelliSense），Prettier 格式化 CSS 就会静默失效；又比如装了 ms-python.python 却漏了 ms-python.pylance，类型提示和跳转基本归零。
真正可靠的批量方案：用脚本解析插件 package.json 中的 extensionDependencies 字段，自动拉取整条依赖链——别信“常用插件合集”打包站，它们几乎从不更新依赖关系。
