拖拽.vsix到主窗口是最稳的离线安装方式：需vscode已启动并打开工作区，拖入未解压.vsix至编辑区（非侧边栏/设置页），松手即弹确认框；失败时优先排查焦点、全屏/远程拦截、文件是否原始vsix。
拖拽.vsix到主窗口是最稳的离线安装方式
只要 VSCode 已启动、且当前打开了一个工作区（哪怕只是空文件夹），直接把未解压的 .vsix 文件拖进编辑器主区域（不是侧边栏、不是设置页、不是终端面板），松手就会弹出确认安装对话框。这是成功率最高、不触发网络请求、不依赖 Marketplace UI 的原生路径。
没反应？先排查这几点：
- VSCode 是否获得系统焦点——任务栏图标未高亮 = 无焦点，点一下编辑器空白处再试
- 是否处于全屏模式或远程桌面（如 RDP/TeamViewer）——这类环境常拦截拖放事件，退出全屏或改用命令行
- 拖的是不是解压后的文件夹或重命名过的
.zip——VSCode 只认原始未解压的.vsix，用unzip -l xxx.vsix应能看到顶层是extension/目录
code --install-extension 命令必须用绝对路径
该命令是批量部署、脚本化或排障时最可靠的入口，但报错即意味着问题明确可查，不会含糊。
常见失败原因：
-
command not found: code—— CLI 未注册，按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH执行一次 -
Extension is not compatible—— 版本不匹配，解压.vsix查package.json中的"engines": {"vscode": "^1.80.0"}，和本地code --version输出的第一段（如1.85.2→ 取1.85）比对 - 路径含空格或中文 —— Windows 必须加英文双引号：
code --install-extension "C:/my ext/ms-python.python-2024.6.0.vsix" - ARM Mac 上装了 x64 构建的插件 —— 尤其含 native 二进制（如
pyright）的插件，需找带darwin-arm64标识的版本
装完插件但 Python 补全/格式化不生效？不是没装上，是依赖没拉下来
像 ms-python.python、esbenp.prettier-vscode 这类插件，首次打开 .py 或 .js 文件时会自动下载语言服务器或 CLI 工具（如 pyright、prettier），默认走外网，离线会卡在状态栏 “Downloading…” 或输出面板报 Failed to fetch。
解决办法不是重装 .vsix，而是：
- 在有网机器上完整跑一遍：打开对应文件类型 → 等状态栏变绿（说明 LSP 已就绪）→ 再把整个扩展目录拷过去
- 路径必须是解压后的完整文件夹，例如
~/.vscode/extensions/ms-python.python-2024.6.0（Linux/macOS）或%USERPROFILE%\.vscode\extensions\ms-python.python-2024.6.0（Windows） - 别只拷
.vsix文件——否则spawn ENOENT错误必现
企业策略禁用时，拖拽和 CLI 都会失效
右下角状态栏显示 Extensions disabled by policy 是最直接的信号。此时 GUI 拖拽、code --install-extension、甚至“从 VSIX 安装…”菜单项都会静默失败。
这种情况下唯一可行的绕过方式是手动解压并放入 extensions 目录，但必须严格还原结构：
- 先用
unzip -l your-extension.vsix查顶层目录名，例如ms-python.python-2024.6.0/—— 这就是扩展 ID + 版本号，必须原样作为子目录名 - 解压后整个文件夹（含
package.json、node_modules等）移入对应extensions路径 - Windows：
%USERPROFILE%\.vscode\extensions\；macOS/Linux：$HOME/.vscode/extensions/
版本兼容性、native 架构、LSP 依赖这三关，漏掉任何一环都可能让插件“已安装”却“不工作”。离线环境里，装上 ≠ 能用，得看它背后有没有真正跑起来。
