VSCode无法识别.vsix文件主因是未加载工作区、组策略禁用、code命令未配置或路径错误；需先打开文件夹、检查Extensions disabled by policy提示、执行Shell Command注册code、路径加引号，再用--allow-unverified跳过离线签名验证。
VSCode 无法识别 .vsix 文件，基本不是文件“打不开”，而是它压根没进入安装流程——多数情况是 VSCode 拒绝加载，或根本没收到有效信号。
拖拽/双击无响应？检查 VSCode 是否已加载工作区
纯空白启动的 VSCode（没打开任何文件夹或文件）不响应拖拽 .vsix 文件，这是设计行为，不是 bug。它只在有活动工作区时才启用扩展安装入口。
- 打开任意文件夹（
File → Open Folder），或至少打开一个本地文件（如README.md） - 再尝试将
.vsix文件拖到编辑器主区域（不是侧边栏、不是设置页） - 如果仍无反应，右下角状态栏出现
Extensions disabled by policy，说明企业组策略禁用了扩展，GUI 和 CLI 都会失效，只能手动解压到~/.vscode/extensions/（Linux/macOS）或%USERPROFILE%\AppData\Roaming\Code\extensions\（Windows）
code --install-extension 报错 ENOENT 或 “not found”？路径和 CLI 环境必须对齐
报 ENOENT 不代表插件坏了，而是命令找不到文件或 code 命令本身未注册进系统 PATH。
- 先运行
code --version：若提示command not found，需在 VSCode 中按Ctrl+Shift+P，执行Shell Command: Install 'code' command in PATH - 路径含空格或中文时，必须用英文引号包裹：
code --install-extension "C:\Users\张三\Downloads\python-2024.6.0.vsix" - 推荐用绝对路径，避免相对路径在不同终端工作目录下失效
装上了但扩展图标灰色、点启用就失败？依赖或激活条件未满足
VSCode 安装成功 ≠ 扩展能运行。很多插件需要显式启用，或依赖其他扩展、语言服务器、甚至特定文件类型关联。
- 在扩展面板中找到该插件，确认右侧启用按钮是蓝色（非灰色圆点）
- 查看输出面板（
Ctrl+Shift+U）→ 切换到Extension Host或对应插件名频道，找类似Cannot activate extension 'xxx' because it depends on unknown extension 'yyy'的报错 - 常见依赖缺失：比如
ms-python.python依赖ms-python.vscode-pylance；esbenp.prettier-vscode依赖本地prettierCLI（离线需提前装好） - 某些插件（如 Office Viewer）只有打开
.docx或.pdf文件时才激活，不打开对应文件，它就一直“休眠”
离线环境报 INVALID_SIGNATURE？别重下，加参数跳过签名验证
离线时 INVALID_SIGNATURE 错误几乎 100% 是证书链不可达导致的校验中断，不是文件损坏，也不是签名被篡改。
- 直接加
--allow-unverified参数重试：code --install-extension python.vsix --allow-unverified - 这个参数只跳过签名检查，不影响版本兼容性判断——如果加了还失败，问题一定出在
package.json的engines.vscode字段与本地版本不匹配 - 验证方式：用 ZIP 工具打开
.vsix，读取extension/package.json，比对"engines": {"vscode": "^1.90.0"}和你运行code --version的结果
最容易被忽略的是：插件虽已安装并启用，但 VSCode 没把它和文件类型真正绑定。比如装了 vscode-pdfviewer，却没在资源管理器里双击 PDF，或拖拽时误拖进了终端窗口——它不会自动弹出来，得靠用户触发一次对应文件的打开动作，才能完成最后的激活闭环。
