拖进主窗口是最稳的安装方式；需VSCode运行、文件未解压、非全屏、有焦点、拖至主编辑区，安装后须手动启用或重启。
拖进主窗口是最稳的安装方式
只要 VSCode 正在运行，把 .vsix 文件直接拖到编辑器主界面（不是侧边栏、不是设置页、不是终端面板），松手就会弹出确认安装框——这是离线环境下成功率最高、路径最短的方法。
常见失败原因：
-
.vsix文件被解压成了文件夹，拖进去无效 - VSCode 处于全屏状态或远程桌面连接中，系统拦截了拖放操作
- 窗口没获得焦点（比如后台运行着多个 VSCode 实例）
- 拖到了错误区域（如资源管理器侧边栏、扩展面板空白处）
- 安装后插件默认处于禁用状态，需手动点击「启用」或重启 VSCode 才生效
命令行安装适合批量或脚本化部署
如果已配置 CLI（即终端里执行 code --version 能正常返回版本号），code --install-extension 是唯一可靠的命令行入口。它不走网络，只读取本地文件并写入扩展目录。
关键细节：
- 必须用绝对路径：
code --install-extension /home/user/ext/prettier-3.2.5.vsix（Linux/macOS）或code --install-extension C:\ext\eslint-2.4.0.vsix（Windows，推荐双反斜杠或正斜杠） - 相对路径容易失败，尤其在非 VSCode 启动的终端中
- 每条命令最多支持 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.80.0"），确认你的 VSCode 版本满足最低要求 - 在扩展面板搜索插件名，看右上角是否显示
Disable (Workspace)——当前工作区可能禁用了它 - 按
Ctrl+Shift+P→ 输入Developer: Toggle Developer Tools→ 切到 Console 标签页，看有没有Extension host terminated或activation failed类错误
签名不合法会导致自动卸载
VS Code 会校验插件签名。从非官方渠道下载的插件（比如 GitHub Release、第三方打包站），若未用微软认可的证书签名，启动时会被自动清理。
现象：
- 安装完重启 VS Code，插件消失
- 日志里出现
Extension 'xxx' is not signed
临时解决（仅调试用）：
- 启动时加参数：
code --disable-extension-corruption-check - 不推荐长期开启，生产环境应优先使用 Marketplace 官方下载或可信源构建的包
vscode-server 版本匹配，单改前端 .vsix 没用；另外，改完 package.json 后必须重打包为 .vsix，直接修改原压缩包内容不生效。 
