推荐用微软官方vsce工具批量下载：先npm install -g vsce，再vsce download ms-python.python --version 2024.12.1；依赖插件（如jupyter）需单独下载，并验证VSCode版本、OS架构及extensionKind兼容性。
怎么批量下载多个插件的 .vsix 文件
离线环境最耗时的不是安装，而是凑齐一整套能用的插件包。手动点“Download Extension”只适合装一两个，团队部署或标准化环境必须批量处理。
推荐用 vsce 命令行工具，它由微软官方维护，支持按 ID 和版本精准拉取：
- 先在联网机器上全局安装：
npm install -g vsce - 查插件 ID：打开插件市场页，URL 里
publishers/xxx/vsextensions/yyy中的xxx.yyy就是完整 ID（如ms-python.python） - 下载指定版本：
vsce download ms-python.python --version 2024.12.1，生成ms-python.python-2024.12.1.vsix - 批量下载可写个简单脚本，把 ID 和版本列在
extensions.txt里，逐行执行vsce download
注意：vsce 不会自动解决依赖，像 ms-python.python 依赖的 ms-toolsai.jupyter 得单独下载——漏掉一个，Python 插件就卡在 “Downloading…” 状态。
为什么装了插件却不生效
很多插件（如 ms-python.python、vue.volar、esbenp.prettier-vscode）只装 .vsix 是注册前端，首次启用才拉取语言服务器（LSP），离线环境下直接卡住。
这不是安装失败，而是懒加载依赖没落地。正确做法是：
- 在有网机器上完整触发一次：打开一个
.py或.vue文件 → 等状态栏显示 “Ready” 或 “Running” - 再把整个扩展目录拷到内网机对应路径下：
Linux/macOS：~/.vscode/extensions/ms-python.python-2024.12.1/
Windows：%USERPROFILE%\AppData\Roaming\Code\Extensions\ms-python.python-2024.12.1\ - 必须包含
node_modules和二进制可执行文件（如server.js、pyright），只拷.vsix文件没用 - 复制完要彻底退出 VSCode（包括托盘进程），否则缓存不刷新
如何避免版本和架构踩坑
code --install-extension 报 “not compatible” 不是模糊提示，VSCode 在读取 .vsix 内部 package.json 后立刻拒绝，关键看三个字段：
-
"engines": { "vscode": "^1.80.0" }：运行code --version，取前两位（如1.85.2→1.85），必须 ≥ 插件声明的最低版本 -
"extensionKind": ["workspace"]：若为["workspace"]，说明插件只能在远程开发（SSH / Dev Container）中加载，本地安装后不会激活 -
"os": ["win32"]或"os": ["darwin"]：ARM Mac 装了 x64 编译的插件（尤其含 native binary 的，如pyright、volar-server），会静默跳过加载，且不报错
验证方法：用 unzip -l xxx.vsix 查顶层是否含 extension/ 目录；ARM Mac 上务必确认 package.json 里有 darwin-arm64 构建标识，别只认版本号。
命令行批量安装必须注意的细节
图形界面点选在内网批量操作时极易卡死或静默失败，code --install-extension 是唯一可脚本化、可复现的路径。但容错极低，几个细节错一个就白忙：
- 所有路径必须是绝对路径：
/opt/vsix/eslint.vsix（Linux/macOS），C:/vsix/prettier-9.10.3.vsix（Windows，推荐正斜杠） - 路径含空格或中文？必须加英文双引号：
"C:/my tools/vue-language-1.8.27.vsix" - 不能写成
code --install-extension a.vsix b.vsix——每个参数必须独立：code --install-extension "/a.vsix" --install-extension "/b.vsix" - 安装前必须关掉所有 VSCode 进程（Windows 查任务管理器，macOS/Linux 执行
ps aux | grep code） - 同名插件已存在高版本时，默认拒绝降级，加
--force强制覆盖；签名验证失败加--allow-unverified
真正麻烦的从来不是“能不能装”，而是“装完能不能用”。很多插件表面绿色勾选，实则 LSP 二进制缺失、架构不匹配、或依赖插件根本没装——这些都得靠真实文件操作和输出面板验证，不能只信扩展列表。
