VSCode离线安装VSIX最稳方式是拖入主界面：确保VSIX未解压、VSCode有焦点且非全屏/远程状态，安装后需手动启用；命令行用code --install-extension加绝对路径；手动复制需解压后按扩展ID目录名放入extensions文件夹并重启。
VSCode 离线安装 VSIX：直接拖进窗口最稳
只要 VSCode 正在运行，把 .vsix 文件拖到编辑器主界面（不是侧边栏、不是设置页），松手就能弹出安装确认——这是离线环境下成功率最高、路径最短的方式。它绕过了 Marketplace 请求、跳过了网络校验，也不依赖 code --install-extension 命令是否配置了 CLI。
- 必须确保拖入的是完整未解压的
.vsix文件（不是 zip 解压后的文件夹） - 如果拖入后无反应，大概率是 VSCode 没获得焦点，或当前处于全屏/远程 SSH 连接状态（某些内网远程桌面会拦截拖放）
- 安装完成后不会自动启用，需手动点「启用」或重启 VSCode
命令行安装 vsix：适用于批量或脚本化部署
在能调用 VSCode CLI 的环境里（即已执行过 code --version 且返回正常），code --install-extension 是唯一可靠命令行入口。它不走网络，只读取本地文件并写入扩展目录。
- 路径必须是绝对路径，相对路径容易失败：
code --install-extension /opt/vscode-ext/prettier-3.2.5.vsix - Windows 下注意反斜杠转义问题，推荐用正斜杠或双反斜杠：
code --install-extension C:/ext/vscode-eslint-2.4.0.vsix - 安装后扩展默认禁用，尤其当插件有权限声明（如
"workspace" "terminal"）时，首次启用会再次弹窗提示
手动复制到 extensions 目录：适合无 GUI 或权限受限场景
当无法拖放、CLI 不可用、或目标机器是纯终端服务器时，直接解压 + 复制到 ~/.vscode/extensions/（Linux/macOS）或 %USERPROFILE%\AppData\Roaming\Code\Extensions\（Windows）是底层可行方案。
- 先用
unzip -l xxx.vsix看下包内顶层目录名，例如esbenp.prettier-vscode-9.10.3/—— 这个就是扩展 ID + 版本号，必须原样作为子目录名 - 不能把整个
.vsix放进去，也不能解压后丢掉外层目录；否则 VSCode 启动时识别不到，日志里会出现Extension 'xxx' is not installed - 复制完需完全退出 VSCode（包括右下角托盘进程），再重新打开，否则缓存可能跳过加载
安装后插件不生效？重点查这三处
离线安装最常卡在「看似装上了，但功能没出来」，往往不是安装失败，而是环境或配置没对齐。
- 检查 VSCode 版本兼容性：打开
.vsix解压后的package.json，看"engines": {"vscode": "^1.75.0"}—— 如果你用的是 1.72，那它根本不会被加载，也不会报错 - 确认工作区没禁用该扩展：在扩展面板搜索插件名，看右上角是否显示「禁用于此工作区」，内网环境常因策略预设了
"extensions.ignoreRecommendations": true - 查看开发者工具控制台：按
Ctrl+Shift+P→ 输入Developer: Toggle Developer Tools，切换到 Console 标签页，过滤extensionHost，真实错误（如依赖模块缺失、激活失败）会在这里吐出来
离线装插件真正的麻烦不在“怎么放进去”，而在“怎么让它真正活过来”——版本锁、工作区策略、依赖链缺失，这三个点藏得深，但一一对上就清楚了。
