最稳的本地打包方式是用官方工具vsce命令行下载：先npm install -g vsce，再执行vsce download ms-python.python@2024.6.0，可精准匹配插件ID与版本号，避免缓存或兼容性问题。
用 vsce download 下载指定版本的 .vsix 文件
最稳的本地打包方式不是手动点下载，而是用官方工具 vsce 从命令行拉取——它能精准命中插件 ID 和版本号，避免网页缓存或镜像站返回旧包的问题。
先全局安装工具：npm install -g vsce（需 Node.js ≥18）
然后执行下载命令，例如获取 Python 插件 2024.6.0 版本：vsce download ms-python.python@2024.6.0
- 插件 ID 格式是
{publisher}.{name}，必须和package.json里一致，不能只写python - 不加
@version会默认拉最新版，但最新版可能不兼容你的 VSCode（比如要求 ≥1.85，而你用的是 1.84） - 下载的文件名形如
ms-python.python-2024.6.0.vsix，建议保留原名，别重命名成python.vsix——否则批量安装时容易混淆版本
手动拼接 Marketplace 官方 API URL 下载
当 vsce 不可用（比如内网机器没装 Node），或者你想绕过 npm 直接用 wget/curl 批量拉取时，就得手拼 URL。
正确格式是：https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension_name}/{version}/vspackage
-
{publisher}是发布者名（如ms-python），不是用户名或 GitHub ID -
{extension_name}是插件名（如python），注意它不带 publisher 前缀，也不含小数点后半段（比如ms-python.python的 extension_name 就是python） -
{version}必须完全匹配市场页显示的版本号，多一位、少一位都会 404 - 该链接返回的是无重定向的直链，但不带签名；若在离线环境用
code --install-extension安装，必须加--allow-unverified
检查并导出真实依赖关系
单个 .vsix 文件只是“表面插件”，很多功能实际依赖其他扩展。比如装了 esbenp.prettier-vscode 却没装 bradlc.vscode-tailwindcss，格式化 Tailwind 类名就会失效。
真实依赖藏在 .vsix 解压后的 package.json 的 extensionDependencies 字段里，不是插件页面写的 “Recommended”。
- 解压 .vsix（它本质是 zip）：
unzip python.vsix -d python-unpacked - 查看依赖：
cat python-unpacked/package.json | jq '.extensionDependencies' - 批量部署前，先在一台已配好的联网机器上运行：
code --list-extensions --show-versions > extensions.txt，再逐行用vsce download拉取所有条目
验证 .vsix 是否适配当前 VSCode 版本
装完不生效？大概率是版本不兼容。VSCode 不会报错提示，只会静默跳过加载。
关键字段在 .vsix 解压后的 package.json 中：engines.vscode。
- 值为
^1.85.0表示最低要求 VSCode 1.85.x，低于此版本无法启用 - 运行
code --version查当前版本，务必比对主版本号（如 1.84 vs 1.85） - 有些插件还限制最大版本（如
），超了也会拒绝加载，但市场页 Requirements 栏通常只写最低要求 - 别信 GitHub Release 页面的 .vsix：很多开源项目未同步更新 release 包，
engines.vscode字段可能还是半年前的旧值
真正麻烦的不是下载或安装，而是依赖树和版本约束——它们不会在 UI 里显式提醒，只有等某个功能突然失灵时才暴露出来。
