最稳的离线安装方式是拖拽未解压.vsix文件至已加载工作区的VSCode主编辑区；需满足VSCode运行、有焦点、非全屏/远程状态，安装后须手动启用或重启。
拖进主窗口是最直接的加载方式
只要 VSCode 正在运行且已打开一个工作区（哪怕只是空文件夹），把未解压的 .vsix 文件直接拖到编辑器主区域（不是侧边栏、不是设置页、不是终端面板），松手就会弹出安装确认框——这是离线环境下成功率最高、路径最短的操作。
常见失败原因包括：
-
.vsix文件被解压成了文件夹，拖进去无效 - VSCode 处于全屏状态，或通过远程桌面连接，系统拦截了拖放操作
- 窗口没获得焦点（比如后台运行着多个 VSCode 实例）
- 拖到了错误区域（如资源管理器侧边栏、扩展面板空白处）
- 安装后插件默认处于禁用状态，需手动点击「启用」或重启 VSCode 才生效
命令行安装必须用绝对路径且 CLI 已注册
code --install-extension 是批量部署、脚本化或排障时最可靠的入口，但它不自动修复环境问题，报错即意味着问题明确可查。
关键实操要点：
- Windows 下路径含空格或中文，必须加双引号：
code --install-extension "C:\ext\prettier-3.2.5.vsix" - Linux/macOS 必须用绝对路径：
code --install-extension /home/user/ext/esbenp.prettier-vscode-9.10.3.vsix - 若提示
command not found: code，说明 CLI 未注册：按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH并回车 - 每条命令最多支持 10 个
--install-extension，超了要分批；失败时会明确打印错误，例如Unable to install extension 'esbenp.prettier-vscode' as it is not compatible with VS Code '1.79.2'
装上了但功能没反应？重点查版本兼容和依赖缺失
离线安装最常卡在「看似装上了，但功能没出来」，往往不是安装失败，而是环境或配置没对齐。
排查顺序：
- 解压
.vsix，打开package.json，检查engines.vscode字段（如"^1.85.0"），确认你的 VSCode 版本满足最低要求（运行code --version对照） - 在扩展面板搜索插件名，看右上角是否显示
Disable (Workspace)—— 当前工作区可能禁用了它 - 查看
package.json中的extensionDependencies字段，比如esbenp.prettier-vscode依赖bradlc.vscode-tailwindcss，缺了就静默失效 - 打开开发者工具（
Ctrl+Shift+P→Developer: Toggle Developer Tools），看 Console 是否有activation failed或Extension host terminated
签名不合法会导致插件被自动卸载
从非官方渠道下载的插件（GitHub Release、第三方打包站等），若未用微软认可的证书签名，VSCode 启动时会自动清理它。
现象是：安装完重启 VSCode，插件消失，日志里出现 Extension 'xxx' is not signed。
临时应对（仅调试用）：
- 启动时加参数：
code --disable-extension-corruption-check - 或安装时加
--allow-unverified参数：code --install-extension xxx.vsix --allow-unverified
长期方案仍是换用可信来源的 .vsix，或联系作者更新签名。签名验证绕不过去，它不是 bug，是 VSCode 的安全基线。
