离线安装VSCode插件失败主因是版本不匹配、依赖缺失或策略禁用；拖拽无反应需确认已加载工作区、有系统焦点且为原始.vsix文件；命令行报“not compatible”须比对code版本、package.json中engines字段及架构；语言插件不生效因缺LSP服务器，需在有网机预装后整目录迁移；策略禁用时只能手动解压直装至extensions目录。
离线环境下 VSCode 插件装不上，八成不是操作错了，而是卡在版本校验、依赖缺失或策略禁用上——拖进去没反应、命令行报 not compatible、装完补全不生效，都是典型信号。
拖 .vsix 文件进 VSCode 主窗口没反应？先确认三个硬条件
这不是“功能失效”，而是 VSCode 拒绝响应拖放的明确状态：
- VSCode 必须已加载一个工作区（哪怕只是打开一个空文件夹），纯启动页或远程连接未就绪时拖放会被静默忽略
- 窗口必须有系统焦点（任务栏图标高亮，且未处于全屏/多显示器缩放偏移状态）
- 拖的是原始
.vsix文件，不是解压后的文件夹、.zip或双后缀文件（如prettier.vsix.zip）
验证方法：unzip -l your-plugin.vsix 应显示顶层含 extension/package.json；若报错或结构混乱，说明文件已损坏。
code --install-extension 报 “not compatible with Code” 怎么查根源
这个错误只告诉你“不兼容”，但不会说哪一环不匹配。必须手动比对三处：
- 运行
code --version，取第一位小数点前的数字（如1.85.2→1.85） - 解压
.vsix，打开extension/package.json，找"engines": {"vscode": "^1.80.0"}字段 - Help → About 里括号中的架构（
arm64/x64）是否与插件构建目标一致（ARM Mac 装 x64 插件会卡在 native 二进制加载）
注意：^1.80.0 表示最低支持 1.80.0，你用 1.79.2 就会被跳过——不报错、不提示，只是不加载。
插件装上了但 Python/ESLint/Prettier 不生效？缺的是 LSP 服务器，不是插件本身
像 ms-python.python、dbaeumer.vscode-eslint 这类语言插件，安装只是注册，首次启用才会下载 pyright、eslint CLI 或 prettier 二进制——这些默认走外网，离线会卡在状态栏 “Downloading…” 或输出面板报 spawn ENOENT。
- 正确做法：在有网机器上完整跑一次——打开一个
.py文件 → 等状态栏变绿 → 再拷整个插件目录（如ms-python.python-2024.6.0/）到内网机器对应extensions/目录 - 不能只拷
.vsix，也不能只拷node_modules；native 二进制（如pyright-server）藏在子目录里，漏一个就启动失败 - 验证方式：View → Output → 切换到 Python 或 ESLint 面板，看是否有
Failed to fetch或spawn ENOENT
企业策略禁用扩展安装时，唯一可行方案是手动解压直装
右下角出现 Extensions disabled by policy 提示，意味着 GUI 和 code --install-extension 都会失败。此时只能绕过签名验证：
- 用
unzip extension.vsix -d extension-unpacked解压到空文件夹 - 找到用户
extensions目录：
– Windows:%USERPROFILE%\AppData\Roaming\Code\Extensions\
– macOS/Linux:$HOME/.vscode/extensions/ - 把解压后的文件夹重命名为
publishername.extensionname-version（如esbenp.prettier-vscode-9.10.3），再移入extensions目录 - 彻底退出 VSCode（包括托盘进程），再重启；按
Ctrl+Shift+P输入Developer: Show Running Extensions确认状态为 “Local”
这种方案无法自动更新，部分依赖 node_modules 的插件可能运行异常，但它是策略封锁下的唯一通路。
