最可靠批量安装VSCode插件的方式是code --install-extension配合脚本，需满足：code在PATH中、每个参数跟绝对路径、路径含空格用英文双引号、安装前关闭所有VSCode进程、离线环境需拷贝完整扩展目录、注意VSCode与插件架构匹配。
用 code --install-extension 命令批量装插件最可靠
图形界面点选或拖.vsix文件进窗口，在多台机器上重复操作既慢又容易漏装、静默失败。真正能落地的批量方式，只有 code --install-extension 配合脚本——它不依赖 GUI 状态，可写入批处理、PowerShell 或 Shell 脚本，且失败会明确报错。
关键约束有三个：
-
code命令必须已加入系统 PATH（安装时务必勾选“添加到 PATH”），否则直接报command not found: code - 每个
--install-extension参数后必须跟一个绝对路径，不能合并多个路径：错误写法code --install-extension a.vsix b.vsix；正确写法code --install-extension "C:/vsix/python-2024.6.0.vsix" --install-extension "C:/vsix/prettier-9.10.3.vsix" - 路径含空格或中文时，必须用英文双引号包裹；Windows 推荐统一用正斜杠
C:/vsix/，避免反斜杠转义问题
先关掉所有 VSCode 进程，再执行安装
后台残留的 VSCode 进程（尤其是托盘里的）会导致部分插件解压不全、激活逻辑跳过，最终表现为“已安装”但无功能。这不是 bug，是 VSCode 的扩展生命周期机制决定的。
Windows 下推荐执行两步确认：
- 运行
code --status，检查输出中是否还有 running extensions 或 processes - 任务管理器里结束所有
Code.exe进程（包括后台服务进程），再运行安装命令
Linux/macOS 同理：先 pkill -f "code"，再执行安装。
前端/语言类插件光装 .vsix 不够，得拷完整扩展目录
像 ms-python.python、Vue.volar、esbenp.prettier-vscode 这类插件，.vsix 文件只包含前端代码和声明，真正的语言服务器（如 pyright-server、volar-server）是在首次打开对应文件时懒加载的。离线环境里这一步必然卡住，状态栏一直显示 “Downloading…”。
正确做法是：在一台能联网的机器上，完成一次真实触发：
- 安装该插件 → 打开一个
.py或.vue文件 → 等状态栏显示 “Ready” 或 “Running” → 关闭 VSCode - 然后拷贝整个扩展目录：
Windows 路径为%USERPROFILE%\AppData\Roaming\Code\Extensions\ms-python.python-2024.6.0\
Linux/macOS 路径为~/.vscode/extensions/ms-python.python-2024.6.0/ - 把这个文件夹直接复制到目标机器的相同路径下（注意版本号要一致）
批量部署前必须核对 VSCode 架构与插件平台标识
ARM Mac 上装 x64 版本的 .vsix，VSCode 不会报错，也不会提示架构不匹配，而是静默跳过 native 二进制加载——结果就是 TypeScript 补全失效、Pylance 不工作、调试器断点不命中。
验证方法很简单：
- 在目标机器上运行
code --version，看 Help → About 显示的架构是x64还是arm64 - 解压任意一个
.vsix文件（改后缀为.zip即可），打开package.json，搜索engines和platform字段，确认是否有darwin-arm64或win32-x64等平台标识 - 尤其注意从 GitHub Release 页面下载插件时，别只认版本号，得盯紧平台后缀（比如
volar-1.10.0-darwin-arm64.vsix）
跨平台批量部署最容易忽略这点，等上百台机器都装完才发现一半没功能，重来成本极高。
