直接拖进VSCode主窗口安装失败，主因是VSCode未加载工作区、无系统焦点、或拖入非原始.vsix文件；code --install-extension报不兼容需比对VSCode版本、package.json中engines字段及架构匹配。
直接拖进 VS Code 主窗口就能装，但绝大多数“提示手动安装却装不上”，根本不是插件问题，而是环境没对上——VSCode 没焦点、文件不是原始 .vsix、或压根没加载工作区。
拖进窗口没反应？先盯住这三件事
这是离线安装里最高频的“假失败”，VSCode 不报错，只静默忽略：
- VSCode 必须已加载工作区（空白窗口、远程 SSH 或刚启动未打开文件夹时，拖放会被直接跳过）
- 窗口必须有系统焦点（任务栏图标高亮，且不能处于全屏模式或 RDP/TeamViewer 远程桌面中）
- 拖的是未解压的原始
.vsix文件（不是.zip、不是重命名过的.vsix.zip、也不是解压后的文件夹；可用unzip -l xxx.vsix验证顶层是否含extension/package.json）
code --install-extension 报 “not compatible” 怎么查
这个错误不告诉你具体哪不兼容，得手动比对三处：
- 运行
code --version，取输出第一位小数点前的版本号（如1.85.2→1.85） - 解压
.vsix，打开extension/package.json，找"engines": {"vscode": "^1.80.0"}字段 - 打开 VS Code 的 Help → About，看括号里是
x64还是arm64——M1/M2 Mac 装 x64 构建的插件，native 二进制会加载失败
注意：^1.80.0 表示最低需 1.80.0，你用 1.79.2 就会被跳过，不报错、不提示，只是插件不激活。
从 Marketplace 下载的 .vsix 安装后自动消失
这是 VS Code 的签名校验机制在起作用：非官方渠道下载（比如 GitHub Release 页面直接扒下来的），若没用 Microsoft 认可的证书签名，启动时就会被自动卸载。
- 现象：安装完重启 VS Code，插件没了，开发者工具 Console 里出现
Extension 'xxx' is not signed - 临时调试可用
code --disable-extension-corruption-check启动（不推荐长期开） - 根本解法：只从
marketplace.visualstudio.com页面点 Download Extension 按钮获取的.vsix，或确认文件签名来自Microsoft Corporation
命令面板里找不到 Extensions: Install from VSIX
说明扩展系统本身已损坏，不是网络或权限问题：
- 按
Ctrl+Shift+P输入Extensions: Show Installed Extensions—— 若无响应、白屏或报command not found，就是 extension host 崩了 - 必须彻底退出所有 VS Code 进程（Windows 任务管理器杀光
Code.exe和Code Helper.exe；macOS 活动监视器查Code和Code Helper (Renderer)） - 重启时加
--disable-extensions参数：终端执行code --disable-extensions，再逐个启用 Python、Pylance 等关键插件定位冲突源
真正卡住的地方，往往不在“怎么装”，而在“装完为什么没用”——VSCode 对不兼容、签名异常、架构错配的处理极其安静，它不会拦你安装，只会默默跳过激活。验证是否真生效，得打开一个 .py 文件，再看 Output 面板里 Python 或 Extension Host 日志有没有报错。
