离线安装vsix插件失败主因是版本不匹配、依赖未就绪或lsp服务缺失；拖放无反应需确认vscode已加载工作区、有系统焦点且拖入原始.vsix文件。
离线安装 VSIX 插件本身不提升开发流畅度，真正卡顿或功能缺失的根源几乎全是版本不匹配、依赖未就绪、或 LSP 服务没下载完——装上了≠能用。
拖进主窗口没反应？先确认 VSCode 是否满足三个硬条件
这是离线场景下最高频的“假失败”，VSCode 不报错也不提示，只是静默忽略拖放动作：
- VSCode 必须已加载一个工作区（哪怕只是空文件夹），纯启动页或远程 SSH 未连接成功时拖放无效
- 窗口必须有系统焦点：点击编辑器任意空白处，确认任务栏图标高亮；全屏、RDP/TeamViewer 远程桌面会拦截拖放事件
- 拖的是原始
.vsix文件，不是解压后的文件夹、.zip、或被浏览器重命名成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"}—— 表示最低要求1.80.0，你用1.79.2就会被跳过 - Help → About 里括号内容（如
arm64）必须与插件构建目标一致；ARM Mac 上装 x64 版本的ms-python.python会卡在 native 二进制加载，Output 面板显示spawn ENOENT
插件显示已安装但 Python/ESLint 功能不生效？大概率缺离线 LSP 服务
像 ms-python.python、dbaeumer.vscode-eslint 这类语言插件，离线安装后首次打开 .py 或 .js 文件时，默认仍会尝试下载 pyright、eslint CLI 等二进制依赖，结果状态栏一直卡在 “Downloading…”。
- 正确做法：在有网机器上完整启用一次该插件（打开对应文件 → 等 LSP 下载完成 → 不卸载），再拷整个插件目录（如
ms-python.python-2024.6.0/）到内网机器的~/.vscode/extensions/（Linux/macOS）或%USERPROFILE%\AppData\Roaming\Code\Extensions\（Windows） - 不能只拷
.vsix，也不能只拷node_modules；native 二进制（如pyright-server）藏在子目录里，漏一个就启动失败 - 验证方式：View → Output → 切换到 Python 或 ESLint 面板，看是否有
Failed to spawn或ENOENT
手动复制 .vsix 解压后目录到 extensions 的容错要点
适用于无 GUI、权限受限或 CLI 不可用的服务器环境，但步骤严格，错一步插件就识别不到：
- 用
unzip -l xxx.vsix查顶层目录名，例如ms-python.python-2024.6.0/—— 这就是扩展 ID + 版本号，必须原样作为子目录名 - 解压后把整个该目录移入对应
extensions路径，不能只复制里面的内容，也不能保留.vsix文件本身 - 复制完必须彻底退出 VSCode（包括右下角托盘进程），否则缓存不刷新，日志里会出现
Extension 'xxx' is not installed
最易被忽略的是：插件是否被工作区禁用。左下角齿轮 → Extensions → 找到插件 → 看右上角有没有 Disable (Workspace)；企业策略还可能全局禁用，右下角状态栏会显示 Extensions disabled by policy。
