最稳的快捷方法是拖拽未解压.vsix文件至VSCode主编辑区，松手即弹安装框；需确保VSCode已启动且前台聚焦、文件为原始.vsix、非全屏或远程环境，安装后须手动启用或重启。
最稳的快捷方法就是直接把未解压的 .vsix 文件拖进 VSCode 主编辑区（不是侧边栏、不是设置页），松手即弹出安装确认框——它不依赖 code 命令是否在 PATH，也不校验窗口焦点以外的系统状态，成功率远高于其他方式。
拖拽安装为什么比命令行更快更可靠
拖拽本质是 VSCode 内部事件监听，绕过了 CLI 层所有路径解析和环境变量检查。而 code --install-extension 对路径极其敏感：相对路径一律失效；含空格或中文必须加英文双引号；code 命令没进 PATH 就直接报错。拖拽则完全避开这些环节。
- VSCode 必须已启动且窗口处于前台（任务栏图标高亮即可）
- 拖入的是原始
.vsix文件，不能是解压后的文件夹，也不能是重命名成.zip的副本 - 全屏模式或远程桌面（RDP / TeamViewer）会拦截拖放事件，需先退出全屏再试
拖不进去？先用 unzip -l xxx.vsix 看顶层结构
很多“拖不动”其实是因为文件被错误解压或重打包过。.vsix 是标准 ZIP 格式，但 VSCode 只认顶层含 extension/ 目录的包。如果解压后看到的是 package.json 或一堆源码文件，说明它已被破坏。
- Linux/macOS：运行
unzip -l comate-3.2.1.vsix | head -5，输出首行应为extension/ - Windows：可用 7-Zip 右键 → “浏览压缩包”，确认打开后第一级目录是
extension/ - 若结构不对，回退到有网机器重新下载，或从 GitHub Release 页面找官方发布的
.vsix
装完没反应？重点盯住插件是否启用 + VSCode 是否彻底退出
离线安装后插件默认处于禁用状态，尤其是像 baidu.comate 这类 AI 插件，不点「启用」或不重启 VSCode，Ctrl+Space 补全、侧边栏按钮全部静默失效。
- 安装完成后，必须点击扩展列表中该插件右侧的「启用」按钮，或直接重启 VSCode
- 重启要彻底：Windows 检查右下角托盘是否有 VSCode 进程残留；macOS/Linux 运行
pkill -f code清理后台 - 部分插件（如
volarjs.volar、ms-python.python）首次启用才下载语言服务器，离线环境下必须提前在有网机器上打开对应类型文件（.vue/.py）触发一次完整加载，再拷整个extensions/xxx/目录过去
真正卡住人的从来不是“怎么装”，而是装完以为好了，结果补全不触发、状态栏不显示 Ready、右键菜单没选项——这些几乎都指向同一个事实：插件没启用，或语言服务根本没落地。多花十秒点一下「启用」，比重装三次更有效。
