离线安装 VSCode 扩展需确保 .vsix 可信、版本匹配且未被策略禁用，是官方支持流程；常见失败原因包括版本校验不通过、依赖未下载、路径错误或架构不匹配。
离线安装 VSCode 扩展，只要 .vsix 文件来源可信、VSCode 版本匹配、且没被策略禁用，就能成功——它不是“黑科技”，是 VSCode 官方支持的标准流程，但容易卡在版本校验、依赖缺失或路径错误上。
拖文件进 VSCode 窗口为什么有时没反应
最常用的方式是把 .vsix 文件直接拖进编辑器主区域（就是你写代码的那块白底区域），松手弹出确认框才算有效。没反应常见于以下几种情况：
- VSCode 处于「空白启动页」或「远程连接未就绪」状态：必须已加载一个工作区（哪怕只是打开一个空文件夹）
- 窗口被全屏遮挡、焦点不在 VSCode 上，或系统缩放/多显示器导致拖拽坐标偏移
- 右下角状态栏显示
Extensions disabled by policy：说明企业组策略或管理员锁死了扩展安装，GUI 和命令行都会失败 - 双击
.vsix文件：Windows 默认可能用浏览器打开，或报“无法安装”，必须拖拽而非双击
code --install-extension 命令总报错 Extension is not compatible
这个报错几乎全是版本不兼容导致的，不是网络问题。VSCode 安装时会严格比对 package.json 里的 "engines": {"vscode": "^1.75.0"} 字段和你本地的版本号（code --version 输出的第一段，如 1.85.2 → 取 1.85）。
- 若你本地是
1.72.0，而插件要求^1.75.0，安装会静默跳过或报错，且不会提示具体哪一版才合适 - 解压
.vsix（它本质是 zip 包）后打开package.json，手动核对engines.vscode是最快定位方式 - ARM Mac 装了 x64 构建的插件（尤其含 native 二进制的，如
esbuild、pyright），也会触发同类报错，需找带darwin-arm64标识的版本
插件列表里显示“已安装”，但 Python 补全/格式化不生效
这是离线环境最典型的假成功现象——安装通过了，但插件没激活或依赖没拉下来。关键点在于：
- 语言类插件（如
ms-python.python、esbenp.prettier-vscode）首次启用时，会自动下载 language server 或 CLI 工具（如pyright、prettier），这些行为默认走外网，离线会卡在状态栏“Downloading…”或输出面板报Failed to fetch - 解决办法不是重装
.vsix，而是提前在有网机器上完整跑一遍：打开 .py 文件 → 触发下载 → 等状态栏变绿 → 再把整个扩展目录（如~/.vscode/extensions/ms-python.python-2023.8.0）拷到内网机对应路径 - 别只拷
.vsix文件，要拷解压后的完整文件夹；否则 native 二进制缺失，spawn ENOENT错误必然出现
怎么验证插件真能用，而不是“挂名”
不能只看扩展面板里有没有勾，得进真实场景验证：
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），输入插件相关命令，比如Python: Select Interpreter或Prettier: Format Document，看能否调出 - 打开对应文件类型（如
test.py），检查状态栏是否出现插件图标（如 Python 解释器选择器、Prettier 小齿轮） - 查看输出面板（
View → Output），切换到插件专属通道（如Python、Pylance），观察是否有Starting language server...成功日志，而非connect ECONNREFUSED类错误
真正麻烦的从来不是“怎么装”，而是插件背后那些没声明的网络依赖和架构隐含约束——拖进去那一刻看似完成了，其实只是开始校验。
