拖进主窗口是最稳的安装方式；需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'

装上了但不生效？重点查这三处

离线安装最常卡在「看似装上了，但功能没出来」，往往不是安装失败，而是环境或配置没对齐。

VSCode

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

下载

排查顺序：

• 打开 .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 官方下载或可信源构建的包

真正容易被忽略的是：Remote-SSH 类插件还涉及远端 vscode-server 版本匹配，单改前端 .vsix 没用；另外，改完 package.json 后必须重打包为 .vsix，直接修改原压缩包内容不生效。