离线安装VSCode插件失败主因是vscode版本、.vsix来源、进程状态三者未对齐；须用官方直链下载带签名的正确版本，安装时加--allow-unverified参数，并在有网环境预触发LSP后整目录迁移。
离线安装 VSCode 插件失败，90% 不是网络问题，而是 vscode 版本、.vsix 来源、进程状态三者没对齐——装不进、装了没反应、装上没功能，全卡在这三个点上。
怎么拿到真正能用的 .vsix 文件
别从 GitHub Release 或百度网盘下，那些文件大概率没签名或 engines.vscode 字段过时。官方只认两种来源：
- 打开插件市场页（如
https://marketplace.visualstudio.com/items?itemName=ms-python.python），右侧 Resources 区域点 Download Extension —— 这个按钮生成的是带签名的临时直链，版本和签名都对得上 - 用 API 拼 URL：
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension_name}/{version}/vspackage，其中publisher是ms-python，extension_name是python，version必须和 Version History 里完全一致（比如2026.6.123456）
code --install-extension 命令为什么静默失败
这个命令不报错 ≠ 成功，它会在三个环节直接放弃，且不提示：
-
code命令根本不在 PATH：Windows 在 VSCode 里按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH；macOS/Linux 运行该命令或手动把/usr/bin加入$PATH - 路径不是绝对路径：Linux/macOS 写
/home/user/ext/python.vsix，Windows 写C:/ext/ms-python.python-2026.6.123456.vsix（推荐正斜杠，避免反斜杠转义） - VSCode 进程没关干净：运行
code --status看输出，有进程就杀掉；Windows 任务管理器里确认没有Code.exe，macOS/Linux 执行pkill -f "Code"
离线必须加 --allow-unverified，否则 INVALID_SIGNATURE 错误会拦住所有安装。
拖拽安装没反应？不是文件坏了，是环境没就绪
VSCode 只在三种状态同时满足时才响应拖拽：
- 已加载一个工作区（哪怕只是空文件夹，不能是纯启动页）
- 窗口有系统焦点（任务栏图标高亮，且没全屏、没在 RDP/TeamViewer 中）
- 拖的是原始
.vsix文件（不是解压后的文件夹，不是.vsix.zip双后缀，unzip -l xxx.vsix应显示顶层为extension/目录）
拖进去后默认禁用，必须手动点「启用」，或彻底退出 VSCode 再重开。
装上了却没语法高亮、跳转、诊断？LSP 服务根本没落地
像 ms-python.python、volarjs.volar 这类语言插件，.vsix 只是前端壳，真正的语言服务器（pyright-server、volar-server）要首次启用时联网下载。离线环境下它就卡在 “Downloading…”。
- 正确做法：在同版本联网机上，打开一个
.py或.vue文件，等状态栏显示 “Ready”，再把整个~/.vscode/extensions/ms-python.python-2026.6.0/目录（含node_modules和 native 二进制）拷到内网机对应路径 - 复制完必须彻底退出 VSCode（包括托盘进程），否则缓存不刷新
- 验证是否真可用：打开对应文件类型，看有没有诊断信息、能否
F12跳转、有没有悬停提示——光看扩展面板显示“已安装”没意义
最常被忽略的一点：engines.vscode 字段和本地 code --version 必须严格匹配。差一个小版本号，VSCode 就静默拒绝，连错误都不给。
