.vsix文件离线安装失败主因是损坏、版本不兼容、依赖缺失或策略限制；需用unzip -t校验完整性，确保package.json中vscode版本匹配，用code命令行安装，语言插件还需离线部署LSP服务器等依赖。
离线安装 VSCode 插件，.vsix 文件本身是自包含的，但直接双击或拖入后“没反应”“报错不兼容”“装了却用不了”，八成不是操作错了，而是卡在版本、路径、依赖或策略这四点上。
怎么确认 .vsix 文件没损坏、能被 VSCode 读取
Windows 右键重命名改后缀（比如 .zip → .vsix）会导致文件头损坏，VSCode 安装时会静默失败。必须用解压工具校验或命令行验证：
-
unzip -t your-extension.vsix—— Linux/macOS 下运行，报OK才算完整；报错就别用了 - Windows 推荐用 PowerShell：执行
Copy-Item "old.zip" "new.vsix" -Force（不是重命名，是复制生成新文件） - 打开
.vsix实际是个 ZIP 包，用 7-Zip 或 Archive Utility 解压，确认根目录下有extension/package.json
拖进 VSCode 窗口没反应？检查这三个状态
图形界面安装最简单，但失效场景很具体，不是“不行”，而是条件没满足：
- VSCode 必须已加载工作区（即打开了文件夹或文件），纯空白启动窗口不响应拖拽
- 拖放目标是编辑器主区域（代码显示区），不是侧边栏、设置页、扩展面板本身
- 右下角状态栏出现
Extensions disabled by policy提示 → 说明企业组策略禁用了扩展安装，GUI 和 CLI 都会失败，只能手动解压到extensions/目录
code --install-extension 报 ENOENT 或不兼容？先查 CLI 和版本
命令行安装失败，90% 是环境没配好，不是插件问题：
- 终端运行
code --version报“command not found” → 还没启用 CLI：在 VSCode 中按Ctrl+Shift+P，输入并执行Shell Command: Install 'code' command in PATH - 报
Extension 'xxx' is not compatible with Code→ 不是 VSCode 太旧，而是.vsix里package.json的"engines": {"vscode": "^1.80.0"}要求 ≥ 1.80，而你本地是1.79.2；用unzip -p xxx.vsix extension/package.json | grep engines查声明版本 - 路径含空格必须加引号：
code --install-extension "C:\my extensions\python.vsix"，否则 Windows 会截断
装上了但 Python/Prettier/Rust 插件不工作？native 依赖没离线到位
很多插件安装只是“注册”，首次启用时才下载语言服务器或 CLI 工具（如 pyright、prettier、rust-analyzer），这些默认走外网，离线环境会卡在状态栏“Downloading…”或输出面板报 spawn ENOENT：
- 正确做法：在有网机器上，用同一版本 VSCode 安装插件 → 打开一个
.py文件触发下载 → 等状态栏不再动 → 关闭 VSCode → 拷整个插件文件夹（如ms-python.python-2024.6.0）到内网机的~/.vscode/extensions/ - 不能只拷
.vsix，也不能只拷node_modules子目录——二进制可执行文件（如pyright-server）藏在子目录里，且路径硬编码 - 验证是否真可用：打开命令面板，输入
Python: Select Interpreter或Prettier: Format Document，能弹出选项才算激活成功
真正麻烦的从来不是“怎么装”，而是装完之后插件内部悄悄发起的网络请求、架构不匹配的 native 二进制、还有被策略锁死的扩展管理入口——这些不会报红字错误，只会让你反复重启、怀疑人生。
