直接拖进主编辑区是最稳的离线安装方式;需VSCode运行且有焦点、拖入未解压.vsix文件、松手即弹确认框,装完须手动启用或重启。

直接拖进主编辑区就能装,比点菜单快、比命令行稳,90%的离线安装失败都卡在没拖对位置。
拖文件进主窗口是最省心的导入方式
VSCode 正在运行时,把未解压的 .vsix 文件直接拖到编辑器中央(就是你写代码那块白底区域),松手就会弹出「安装」确认框——它不走网络、不依赖 CLI 配置、也不需要先打开扩展面板。
- 必须拖到主编辑区:拖到侧边栏、终端面板、设置页或资源管理器空白处,都不会触发安装
- 文件不能解压:拖进去的是
prettier-3.2.5.vsix,不是prettier-3.2.5/文件夹 - 窗口要有焦点:如果后台开着多个 VSCode 实例,当前窗口没被激活,拖放会静默失败
- 别在全屏或远程桌面里拖:某些内网远程连接会拦截系统级拖放事件
- 装完默认禁用:右下角提示“已安装”,但插件图标不亮、功能不生效,得手动点「启用」或重启 VSCode
命令行安装只认绝对路径,相对路径基本无效
code --install-extension 是批量部署的唯一可靠入口,但它对路径极其敏感——哪怕你在 .vsix 所在目录下执行 code --install-extension prettier-3.2.5.vsix,也大概率失败。
- Linux/macOS 必须写全路径:
code --install-extension /home/user/ext/prettier-3.2.5.vsix - Windows 推荐正斜杠:
code --install-extension C:/ext/eslint-2.4.0.vsix(双反斜杠也行,单反斜杠会报错) - 每条命令最多支持 10 个
--install-extension,超了要拆成多行 - 失败时会明确报错,比如:
Unable to install extension 'esbenp.prettier-vscode' as it is not compatible with VS Code '1.79.2',这时得去package.json里查engines.vscode字段
手动复制到 extensions 目录是兜底方案
当机器没图形界面、CLI 不可用、或权限受限时,只能解压 .vsix 后复制到 VSCode 的扩展目录。这不是简单“把 vsix 放进去”,而是要还原它的原始目录结构。
- 先用
unzip -l xxx.vsix看顶层目录名,例如esbenp.prettier-vscode-9.10.3/—— 这个名字必须原样作为子目录名 - Linux/macOS 路径是:
~/.vscode/extensions/;Windows 是:%USERPROFILE%\AppData\Roaming\Code\Extensions\ - 不能把整个
.vsix文件丢进去,也不能把解压后的内容平铺进extensions/ - 复制完必须彻底退出 VSCode(包括右下角托盘进程),否则启动时会跳过加载新目录
最容易被忽略的一点:装上了 ≠ 能用。很多插件(尤其是 AI 类或带终端权限的)首次启用会二次弹窗请求授权,而这个弹窗在某些内网环境会被系统拦截或静默丢弃——如果功能灰着,先按 Ctrl+Shift+P → 输入 Developer: Toggle Developer Tools,看控制台有没有 permission denied 或 activation failed 报错。


















