VSCode离线安装插件失败主因是LSP服务器未离线部署、版本不匹配、依赖缺失或文件损坏；需在有网机预装后整目录迁移，校验vsix完整性及package.json引擎版本，并通过Output面板验证LSP启动状态。
VSCode 离线安装 .vsix 包本身不难，真正卡住你的几乎都不是“装不上”，而是“装上了但 Python/ESLint/TypeScript 功能压根不工作”——根源在语言服务器（LSP）没离线就位。
拖进主窗口没反应？先看这三个硬条件
这不是 VSCode 故障，是它主动跳过无效操作：
- VSCode 必须已加载一个工作区（哪怕只是空文件夹），纯空白窗口或远程 SSH 未就绪状态会静默忽略拖放
- 主窗口要有系统焦点（任务栏图标高亮，且不能全屏、不能被 RDP/TeamViewer 拦截）
- 拖的是原始
.vsix文件，不是被浏览器重命名成xxx.vsix.zip或解压后的文件夹
验证方法：用 unzip -l your-extension.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 里括号中的架构（
x64/arm64）必须与插件构建目标一致——ARM Mac 装 x64 插件，native 二进制根本加载不了
注意：^1.80.0 表示最低支持 1.80.0，你用 1.79.2 就会被跳过，且不报错、不提示，只是不加载。
装上了但“自动扫描代码隐患”不触发？缺的是 LSP 服务器，不是插件本身
像 ms-python.python、dbaeumer.vscode-eslint 这类插件，离线安装后首次打开 .py 或 .js 文件时，会尝试下载 pyright、eslint-cli 等二进制依赖，默认走外网，结果状态栏一直卡在 Downloading...。
- 正确做法：在有网机器上完整启用一次该插件（打开对应文件类型 → 等下载完成 → 不要卸载）
- 然后拷整个插件目录（如
ms-python.python-2024.6.0/）到内网机器的%USERPROFILE%\AppData\Roaming\Code\Extensions\（Windows）或$HOME/.vscode/extensions/（macOS/Linux） - 不能只拷
.vsix，也不能只拷node_modules——pyright-server这类 native 二进制藏在子目录里，漏一个就启动失败
验证方式：打开 Output 面板（View → Output），切换到 Python 或 ESLint 通道，看是否有 spawn ENOENT 或 Failed to fetch。
最常被忽略的一点：插件列表里显示“已安装”，不代表能用；它可能连初始化都失败了。真正有效的验证，永远是打开对应文件类型，看有没有语法诊断、悬停提示、右键菜单里的扫描命令是否可调用。
