推荐用官方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…” 状态。
拖拽 .vsix 没反应？检查这三件事
VSCode 对拖放安装有隐性前提，不是文件往窗口一扔就能触发。
- 必须已打开一个工作区（哪怕只是空文件夹），纯欢迎页（Welcome Page）不响应拖放
- VSCode 窗口得是前台焦点状态；远程 SSH 连接未就绪、多显示器缩放偏移、全屏模式下常被系统拦截
- 右下角状态栏若显示
Extensions disabled by policy，说明组策略已禁用扩展，拖放和code --install-extension都会静默失败
验证是否真没反应：把 .vsix 文件拖到 VSCode 窗口边缘，光标变成“+”号才表示识别成功；如果光标没变，基本就是上述三者之一出了问题。
code --install-extension 报 “not compatible” 怎么快速定位
这个错误不是模糊提示，是 VSCode 在读取 .vsix 内部 package.json 后立刻拒绝安装，关键看三个字段。
-
"engines": { "vscode": "^1.80.0" }：运行code --version，取前两位（如1.85.2→1.85），必须 ≥ 插件声明的最低版本 -
"extensionKind": ["ui", "workspace"]：若为["workspace"]，说明插件只能在远程开发（SSH/Dev Container）中加载，本地安装后不会激活 -
"os": ["win32"]或"os": ["darwin"]：ARM Mac 装了 x64 编译的插件（尤其含 native binary 的，如pyright、esbuild），会直接跳过加载，且不报错
快速验证命令（Linux/macOS）：unzip -p your-plugin.vsix extension/package.json | grep -E "(engines|os|extensionKind)"；Windows 可用 7-Zip 直接打开 .vsix 查看。
装完插件不生效？大概率缺 runtime 或 LSP
像 Snippet Generator、Prettier、ESLint 这类插件，本身轻量，但核心功能依赖外部 CLI 或语言服务器。
- Python 插件卡在 “Starting language server…”：说明
pylsp或pyright的二进制没随插件一起打包，需提前在联网机上完整运行一次，让 VSCode 自动下载并缓存node_modules，再把整个~/.vscode/extensions/ms-python.python-xxx/目录拷过去 - Prettier 格式化按钮灰掉：检查插件是否要求全局安装
prettierCLI（npm install -g prettier），离线机没装就无法调用 - Snippets 生成器不响应：部分功能依赖 TypeScript 语言服务解析接口定义，而 TS Server 是独立进程，没随插件分发，需单独部署
真正麻烦的从来不是 “装不上”，而是 “装上了但不动”。离线场景下，插件目录结构、node_modules 存在与否、CLI 是否全局可用，这些细节比版本号更决定成败。
