拖进主窗口是最稳的安装方式；需确保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'
手动复制到 extensions 目录是底层兜底方案
当无法拖放、CLI 不可用、或目标机器是纯终端服务器时，可解压 .vsix 并复制到 VSCode 的 extensions 目录下。
操作要点：
- 先解压
.vsix（它本质是 zip），看顶层目录名，例如esbenp.prettier-vscode-9.10.3/—— 这就是扩展 ID + 版本号，必须原样作为子目录名 - 不能把整个
.vsix文件放进去，也不能丢掉外层目录结构 - Windows 路径为：
%USERPROFILE%AppDataRoamingCodeExtensions；Linux/macOS 为：~/.vscode/extensions/ - 复制完必须完全退出 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类报错
签名问题最容易被忽略：从非官方渠道下载的 .vsix 若未用微软认可证书签名，VSCode 启动时会自动卸载，并在日志里留下 Extension 'xxx' is not signed。这种情况下，拖进去、命令行、手动复制全都会白忙一场。
