拖进主窗口是最稳的安装方式；需VSCode运行、有焦点、加载工作区，拖未解压.vsix至主编辑区触发安装，失败常因全屏/远程拦截、文件解压或拖错区域，安装后须手动启用或重启。
拖进主窗口是最稳的安装方式
只要 VSCode 正在运行，把 .vsix 文件直接拖到编辑器主界面（不是侧边栏、不是设置页、不是终端面板），松手就会弹出确认安装框——这是离线环境下成功率最高、路径最短的方法。
常见失败原因：
-
.vsix文件被解压成了文件夹，拖进去无效 - VSCode 处于全屏状态或远程桌面连接中，系统拦截了拖放操作
- 窗口没获得焦点（比如后台运行着多个 VSCode 实例）
- 拖到了错误区域（如资源管理器侧边栏、扩展面板空白处）
- 安装后插件默认处于禁用状态，需手动点击「启用」或重启 VSCode 才生效
命令行安装必须用绝对路径
code --install-extension 是唯一可靠的命令行入口，但它只读取本地文件并写入扩展目录，不走网络。关键细节是路径必须为绝对路径，相对路径在非 VSCode 启动的终端中极易失败。
实操要点：
- Linux/macOS：
code --install-extension /home/user/ext/prettier-3.2.5.vsix - Windows（推荐正斜杠）：
code --install-extension C:/ext/eslint-2.4.0.vsix - PowerShell 中含空格或中文路径必须加引号：
code --install-extension "D:\my ext\python.vsix" - 每条命令最多支持 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 目录下。
操作要点：
- 先用
unzip -l xxx.vsix查看顶层目录名，例如：esbenp.prettier-vscode-9.10.3/—— 这就是扩展 ID + 版本号，必须原样作为子目录名 - 不能把整个
.vsix文件放进去，也不能丢掉外层目录结构 - Windows 路径为：
%USERPROFILE%\AppData\Roaming\Code\Extensions；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 unexpectedly或签名警告
版本兼容性是静默失效的重灾区：低版本 VSCode 加载高 API 要求的插件，不会报错，也不会提示，只是彻底跳过加载。这个点最容易被忽略。
