批量分发.vsix文件需严格遵循「版本锁定+安装顺序+路径隔离」三原则，否则易导致不激活、报错或功能缺失；必须用code --install-extension逐个安装本地.vsix文件，配合--force参数强制覆盖，并按themes→languages→debuggers→formatters→utility顺序串行执行，安装后须实际测试核心功能验证生效。
直接说结论：批量分发 .vsix 文件不是“打包一个压缩包发过去就行”，关键在「版本锁定 + 安装顺序 + 路径隔离」——缺一不可，否则内网机器上安装后可能不激活、报错或功能缺失。
怎么用 code --install-extension 批量安装本地 .vsix
这是最常用也最可靠的批量安装方式，但前提是 code 命令已加入系统 PATH，且目标机器已安装对应版本的 VSCode（注意 engines.vscode 兼容性）。
-
code --install-extension只接受单个文件路径，不支持通配符或目录，必须显式遍历 - Linux/macOS 推荐用
for file in ./extensions/*.vsix; do code --install-extension "$file" --force; done；--force强制覆盖旧版，避免因版本号相同跳过安装 - Windows PowerShell 请用：
Get-ChildItem ./extensions/*.vsix | ForEach-Object { code --install-extension $_.FullName --force }；CMD 不推荐，容易因空格或路径含中文失败 - 每次调用都会启动 VSCode 后台服务，若插件多（>20 个），建议加
sleep 1或用wait控制并发，防止资源争抢导致安装静默失败
为什么不能直接拷贝 ~/.vscode/extensions 目录迁移插件
看起来最省事，实际风险最高：VSCode 的扩展目录不是纯代码快照，它混杂了编译产物、缓存、激活状态和平台相关二进制（比如 C++ 插件的 ms-vscode.cpptools 会生成 bin/ 下的 native 模块）。
- 跨平台拷贝（如从 macOS 拷到 Windows）必然失败，
bin/下的可执行文件不兼容 - 同一插件不同 VSCode 版本会写入不同结构的
out/或dist/，直接复用可能触发Cannot find module './extension' - 某些插件（如
ms-python.python）首次运行时才下载语言服务器，拷贝目录不会带这些动态资源 - 真正安全的迁移方式是：只导出
code --list-extensions --show-versions清单，再按清单重新下载 .vsix 并安装
如何确保 .vsix 文件来源可信且版本可控
企业环境里，“随便下个 vsix 安装”等于引入未审计的第三方代码。必须控制来源和校验完整性。
- 优先使用官方 CLI 工具
vsce download：例如vsce download ms-python.python --version 2024.12.0，它从 Marketplace 签名源拉取，附带 SHA256 校验值 - 避免从 GitHub Releases 直接下载，除非你确认作者同时发布了
.vsix（很多项目只发源码，vsix 是 CI 自动生成的） - 下载后务必校验：
shasum -a 256 ms-python.python-2024.12.0.vsix对比 Marketplace 页面显示的 checksum - 把所有 .vsix 和对应的
sha256sums.txt一起打包分发，接收方先sha256sum -c sha256sums.txt再执行安装
依赖顺序错误会导致插件不激活，怎么排
VSCode 不自动解析扩展间依赖，但某些插件明确要求前置加载（比如主题插件要早于语法高亮插件，语言服务器插件要早于 LSP 客户端）。
- 查
package.json中的extensionPack字段（如有），这类插件通常需最后安装 - 通用顺序建议：
themes→languages（如 python、rust）→debuggers→formatters/linters（如 prettier、eslint）→utility（如 gitlens） - 最稳妥的做法：用
code --install-extension A.vsix && code --install-extension B.vsix串行执行，别用 & 并发 - 安装后验证是否激活：
code --list-extensions --show-versions | grep "ms-python"看输出是否含版本号，再打开对应语言文件确认语法高亮/智能提示生效
真正麻烦的从来不是“怎么装”，而是“怎么确认它真的在工作”。哪怕脚本跑完没报错，也要打开一个真实文件测试核心功能——比如 Python 插件是否能跳转定义、ESLint 是否标红错误。离线环境里，一次验证成本远高于一次重装。
