vscode离线安装失败的三大原因：未加载工作区、窗口无焦点、.vsix文件损坏；版本不兼容需核对主版本号与架构；手动复制须解压并还原完整目录结构，且需彻底退出vscode刷新缓存。
拖进 VSCode 主窗口没反应，先确认这三件事
VSCode 离线安装最常用也最容易误判失败的方式就是拖 .vsix 文件进主编辑区。它不报错、不弹窗、不提示，只是“没反应”——其实不是插件坏了，是环境没对上。
- VSCode 必须已加载工作区：纯空白启动（没打开文件夹/文件）时，拖放会被静默忽略；至少得打开一个空文件夹或任意文件
- 窗口必须有系统焦点：任务栏图标未高亮、被其他程序遮挡、或处于全屏/远程桌面（如 RDP、TeamViewer）状态，都会拦截拖放事件
- 拖的是原始未解压的
.vsix文件：重命名过（如python.zip改成python.vsix）或用解压工具展开过，会导致 ZIP 头损坏；可用unzip -l xxx.vsix验证顶层是否为extension/目录
code --install-extension 报 “not compatible with Code”，怎么查根源
这个错误只说不兼容，但不会告诉你具体哪一环不匹配。它不看小版本号，只比对主版本号（1.85.2 → 1.85）和架构（x64/arm64），且校验发生在安装瞬间，不依赖网络。
- 运行
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或x64必须与插件构建目标一致；ARM Mac 上装 x64 插件，native 二进制加载会静默失败
手动复制到 extensions 目录为什么还是识别不到
很多人以为把 .vsix 文件直接扔进 ~/.vscode/extensions/ 就算装上了，其实 VSCode 根本不读这个文件——它只在安装流程中解压并写入子目录。手动复制必须还原完整结构，否则插件不会被扫描到。
- 先用
unzip -l xxx.vsix查顶层目录名，例如ms-python.python-2024.6.0/—— 这就是扩展 ID + 版本，必须原样作为子目录名 - 解压后把整个该目录（含
package.json、node_modules、dist等）复制进对应路径：
Windows：%USERPROFILE%\AppData\Roaming\Code\Extensions\
macOS/Linux：$HOME/.vscode/extensions/ - 复制完必须彻底退出 VSCode（包括右下角托盘进程），否则缓存不刷新，新目录会被跳过
插件显示已安装，但 Python/ESLint 功能不生效
语言类插件（如 ms-python.python、dbaeumer.vscode-eslint）离线安装后首次启用，会尝试下载 LSP 服务器（如 pyright、eslint CLI），默认走外网。离线时状态栏卡在 “Downloading…” 或 Output 面板报 spawn ENOENT，不是插件没装好，是 native 依赖缺失。
- 正确做法：在有网机器上先完整启用一次该插件（打开
.py文件 → 等 LSP 下载完成 → 不卸载）→ 拷整个插件目录（如ms-python.python-2024.6.0/）到内网机器对应extensions路径 - 不能只拷
.vsix，也不能只拷node_modules——pyright-server这类二进制藏在子目录里，漏一个就启动失败 - 验证方式：View → Output → 切换到 Python 或 ESLint 面板，看是否有
Failed to fetch或Cannot find module类错误
