VSCode 不支持双击安装 .vsix 文件，仅支持拖入主编辑区、命令行 code --install-extension 或扩展面板中“从 VSIX 安装”三种方式；双击由系统默认解压工具处理，VSCode 不响应且不校验版本兼容性。
VSCode 不支持双击打开 .vsix 文件安装，直接双击会报错或静默失败——这不是 bug，是设计如此。 它只接受拖入主编辑区、命令行调用或通过「扩展面板 → 更多操作 → 从 VSIX 安装」三种方式。双击行为由系统默认关联到 ZIP 解压工具（比如 Windows 的“文件资源管理器”），不是 VSCode 的安装入口。
为什么双击 .vsix 会出问题
常见错误现象包括：Unable to open 'xxx.vsix': File is not a valid VS Code extension. 或直接弹出“无法打开此文件”提示。根本原因有三个：
- VSCode 没注册为 .vsix 文件的默认打开程序（即使注册了，也不处理双击安装逻辑）
- 系统把 .vsix 当作普通 ZIP，调用解压软件打开，导致 VSCode 根本没参与
- 即使你手动右键 → “打开方式 → VSCode”，VSCode 也只会尝试以文本/二进制形式加载该文件，而非触发安装流程
正确安装 .vsix 的三种可靠方式
必须满足前提：VSCode 已运行、有焦点、版本兼容（见后文）、.vsix 文件未解压。
-
拖入主窗口（最推荐）：把未解压的
.vsix文件直接拖到 VSCode 编辑器主区域（即代码显示区，不是侧边栏、不是终端面板、不是设置页），松手即弹确认框；失败时先检查是否全屏、远程桌面连接中、或任务栏图标未高亮（即无焦点） -
命令行安装（适合脚本/批量）：确保已执行
Shell Command: Install 'code' command in PATH，然后终端中运行code --install-extension /absolute/path/to/extension.vsix；路径必须是绝对路径，含空格或中文需加英文双引号 -
扩展面板菜单安装（GUI 最稳）：按
Ctrl+Shift+X打开扩展视图 → 点右上角⋯→ 选Install from VSIX...→ 浏览并选中.vsix文件 → 确认；注意：某些企业策略会禁用该菜单项，此时状态栏会显示Extensions disabled by policy
装完插件却没反应？先查这三处
离线安装后功能缺失，90% 不是安装失败，而是环境未对齐：
- 打开
.vsix解压后的package.json，检查"engines": {"vscode": "^1.80.0"}字段，再运行code --version对比版本；VSCode 1.79.x 装要求 ^1.80.0 的插件，会静默跳过加载，不报错也不提示 - 在扩展面板搜索插件名，看右上角是否显示
Disable (Workspace)—— 当前工作区可能禁用了它，点启用即可 - 部分插件（如
ms-python.python）首次启用会尝试下载语言服务器（LSP），离线环境下卡在Downloading...；需提前准备对应 LSP 的离线包或配置跳过自动下载
最容易被忽略的是版本兼容性校验：VSCode 对不匹配的插件完全静默，既不加载也不报错，只在开发者工具控制台（Ctrl+Shift+P → Developer: Toggle Developer Tools）里留一行 Skipping extension xxx: engine mismatch。不打开控制台，你就永远不知道它根本没启动。
