离线安装VSCode插件失败主因是文件来源错误或流程不完整：须从Marketplace官网下载签名.vsix或用API拼接直链；拖拽需VSCode已加载工作区、聚焦主编辑区且未被远程桌面拦截；code --install-extension需PATH配置、加--allow-unverified、路径纯英文、进程彻底退出；插件功能缺失常因LSP服务未离线预装，且VSCode主版本号必须严格匹配插件engines.vscode字段。
离线安装 VSCode 插件本身不难，难在装完没反应、卡在 Downloading、或者根本拖不进去——这些问题几乎都出在「文件来源不对」或「安装动作没触发完整流程」上。
怎么拿到真正能用的 .vsix 文件
别从 GitHub Release 页面随手点下载，很多插件的 Release 页没同步最新 .vsix，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）
下载后建议重命名，含平台标识，例如 python-2026.6.123456-darwin-arm64.vsix，避免后续在 M 系列 Mac 上误装 x64 版。
拖拽安装没反应？先看这三点是否满足
这不是插件坏了，而是 VSCode 根本没收到安装信号。拖放失败几乎全是这三点没对齐：
- VSCode 必须已加载工作区（即打开了文件夹或至少一个文件）
- 拖入目标必须是编辑器主区域（不是侧边栏、不是设置页、也不是扩展面板本身）
- VSCode 必须有系统焦点（任务栏图标高亮，且未处于全屏或远程桌面 RDP/TeamViewer 等拦截拖放的环境）
右下角若出现 Extensions disabled by policy 提示，说明企业组策略禁用了扩展安装，此时拖放和 code --install-extension 都会静默失败，只能走手动复制路径。
code --install-extension 总报错？盯住路径、签名、进程状态
这个命令不走网络，只读取本地文件并写入扩展目录，但容错极低：
-
command not found: code→ 不是 PATH 问题，而是 VSCode 没启用 Shell Command：按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH并执行 -
INVALID_SIGNATURE→ 离线环境无法校验证书链，必须加--allow-unverified参数：code --install-extension python.vsix --allow-unverified - 装完
code --list-extensions不显示，或重启后仍不生效 → 大概率 VSCode 进程还在后台运行。关掉所有实例（包括系统托盘里的），Windows 下可用任务管理器结束所有Code.exe进程 - 路径含中文或空格（如
C:\用户\张三\vsix\python.vsix）会静默失败，务必移到纯英文路径，例如C:\vsix\python.vsix，且 Windows 下推荐用正斜杠：code --install-extension "C:/vsix/python.vsix"
装上了却没功能？语言服务器根本没落地
很多插件（如 ms-python.python、volarjs.volar）只装 .vsix 只是注册前端，首次启用才下载 LSP 服务（pyright-server、volar-server）。离线环境卡在 Downloading... 就是这个原因。
正确做法：
- 在有网机器上，用同一版本 VSCode 安装该插件
- 打开一个对应类型文件（如
.py或.vue），等状态栏显示Ready - 把整个
~/.vscode/extensions/ms-python.python-2024.6.0/目录（含子目录里的 native 二进制）拷到内网机对应路径下 - 复制完必须彻底退出 VSCode，包括右下角托盘进程，否则缓存不刷新
最常被忽略的一点：VSCode 主版本号和插件 engines.vscode 字段必须严格匹配。比如当前 VSCode 是 1.84.2，而插件要求 ^1.85.0，就会直接拒绝加载，连错误提示都不给。
