离线安装失败主因是VSCode缓存失败状态、残留损坏扩展或校验逻辑卡住；需加--allow-unverified参数、彻底退出进程、清理扩展目录、核对engines.vscode版本并补全LSP服务。
离线安装失败后反复报错，90% 是 VSCode 缓存了失败状态、残留了损坏扩展或校验逻辑被卡住——它不会主动清理，只会不断复现同一错误。
code --install-extension 报 INVALID_SIGNATURE 或静默无响应
离线环境无法连接微软证书服务器，VSCode 默认拒绝未签名或签名链不完整的 .vsix，哪怕文件本身完全合法。
- 必须加
--allow-unverified参数：例如code --install-extension python.vsix --allow-unverified - 别用
sudo执行该命令，否则插件装进/root/.vscode/extensions/，普通用户启动 VSCode 后根本看不到 - 如果仍无响应，先运行
which code；无输出说明 CLI 未注册，需在 VSCode 中按Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH并执行
拖拽安装后卡在 “Installing…” 或直接没反应
这不是插件问题，而是 VSCode 图形界面依赖前台工作区上下文和焦点状态，断网时它不提示、不回退、只挂起。
- 确保已打开一个本地文件夹（哪怕空的）作为工作区：纯欢迎页或远程连接未就绪时，拖放事件被忽略
- 确认窗口有系统焦点：任务栏图标高亮，且不在全屏、RDP、TeamViewer 或多显示器缩放偏移状态下
- 验证文件是原始
.vsix：运行unzip -l my-ext.vsix，应显示顶层为extension/目录，含extension/package.json；若结构散乱或报错，说明文件已被解压或下载损坏 - 路径含中文或空格？Windows 下必须用英文双引号包裹，如
"C:/vsix/ms-python.python-2024.6.0.vsix"
装完显示“已启用”，但 Python/Java/ESLint 功能全失效
语言类插件（如 ms-python.python、redhat.java、dbaeumer.vscode-eslint）的 .vsix 只是前端壳，真正干活的 LSP 服务（如 pyright-server、java-language-server）需首次启用时联网下载。离线即“半残废”。
- 在能联网的机器上完整启用一次该插件（打开对应类型文件，等状态栏不再显示 “Downloading…”），然后复制整个扩展目录：Linux/macOS 路径为
~/.vscode/extensions/ms-python.python-*/，Windows 为%USERPROFILE%\.vscode\extensions\ms-python.python-* - 注意：不是只复制
.vsix文件，而是复制解压后的完整目录（含out/、dist/、server/等子目录） - 粘贴到离线机同路径下，重启 VSCode；若提示冲突，先删掉原目录再覆盖
反复重试仍提示 “Extension is corrupt” 或 “not compatible with Code”
这类错误常因旧版本残留导致校验失败，VSCode 不会自动覆盖，而是拒绝写入。
- 先彻底退出所有 VSCode 进程：Windows 用任务管理器结束全部
Code.exe，macOS/Linux 运行pkill -f "Code Helper"和pkill -f "Electron" - 手动删掉对应扩展目录：
rm -rf ~/.vscode/extensions/ms-python.python-*（Linux/macOS）或用资源管理器删除 Windows 对应文件夹 - 再用
--force参数重装：code --install-extension python.vsix --force - 最后一步关键检查：打开
.vsix内的extension/package.json，确认"engines": {"vscode": "^1.85.0"}中的版本 ≤ 你本地code --version输出（取前两位比对），差一个小版本就会被跳过
最易被忽略的是：LSP 服务缺失和版本字段比对。很多人花一小时重下、重装、重启，却没打开 package.json 看一眼 engines.vscode 字段——它不报错，只沉默跳过。
