如何在VSCode中使用VSIX文件离线安装插件-VSCode-PHP中文网

拖拽.vsix没反应，需确认三件事：vscode已加载工作区、有系统焦点、拖入的是未解压的原始.vsix文件；否则静默失败。

如何在vscode中使用vsix文件离线安装插件

VSCode 离线安装最稳的方式就是直接拖进主编辑区，但它对环境很挑剔：没加载工作区、没焦点、或拖了错误文件，都会静默失败——不报错、不提示、只是没反应。

VSCode 必须已启动且**有系统焦点**：点击编辑器任意空白处，确保任务栏图标高亮；全屏或远程桌面（如 RDP/TeamViewer）会拦截拖放，必须退出再试
必须拖入**未解压的原始 .vsix 文件**：浏览器下载后重命名成 prettier.vsix.zip 或手动解压过，VSCode 都会忽略；可用 unzip -l xxx.vsix 检查顶层是否为 extension/ 目录
窗口必须已加载**至少一个工作区**：空窗口（无文件夹打开）状态下拖放会被跳过；哪怕新建一个空文件夹并用 VSCode 打开，就能满足条件

这个错误只告诉你“版本不匹配”，但不会说明具体哪一环出问题。它背后实际校验三个硬性条件，缺一不可：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

运行 code --version，取输出中第一位小数点前的版本号（如 1.92.2 → 1.92）
解压 .vsix，打开 extension/package.json，找 "engines": {"vscode": "^1.85.0"} 字段：你本地版本必须 ≥ 插件声明的最低版本
检查架构一致性：Help → About 里括号内容（如 arm64 或 x64）必须与插件构建目标一致；ARM Mac 上装 x64 插件，尤其含 native 二进制的（如 pyright），会卡在加载阶段

像 ms-python.python、dbaeumer.vscode-eslint 这类语言插件，离线安装后只是注册成功，首次激活时才会拉取语言服务器（如 pyright-server、eslint-cli）。内网环境下，这一步必然卡在 “Downloading…” 状态栏。

正确做法：在有网机器上完整启用一次该插件——打开一个 .py 文件，等状态栏不再显示下载提示，再关闭 VSCode
然后拷整个插件目录（如 ms-python.python-2024.6.0/）到内网机的 $HOME/.vscode/extensions/（Linux/macOS）或 %USERPROFILE%\AppData\Roaming\Code\Extensions\（Windows）
不能只拷 .vsix，也不能只拷 node_modules；native 二进制藏在子目录里，漏一个就触发 spawn ENOENT
验证方式：View → Output → 切换到 Python 或 ESLint 通道，看是否有 Failed to fetch 或长时间不动

这不是复制路径错了，而是目录结构没对齐。VSCode 启动时扫描 extensions/ 下每个子目录，只认符合「扩展 ID + 版本号」命名规范的文件夹，且必须包含完整的解压内容。

先用 unzip -l your-extension.vsix 查顶层目录名，例如 ms-python.python-2024.6.0/ —— 这就是扩展 ID 和版本，必须原样作为子目录名，不能删减或改写
解压后把整个 ms-python.python-2024.6.0/ 目录（含 package.json、node_modules、out/ 等）移入对应 extensions 路径
不能只复制里面的内容，也不能保留 .vsix 文件本身；复制完必须彻底退出 VSCode（包括右下角托盘进程），否则缓存不刷新

复杂点在于：版本兼容性、LSP 依赖、目录结构三者都得对齐，而 VSCode 对任一环节失败都保持沉默。最容易被忽略的是——插件“已安装”不等于“已激活”，更不等于“已准备好语言服务”。