离线安装vscode插件失败主因是.vsix文件不可用、vscode版本不匹配或依赖缺失；应从官方市场页下载带签名的直链.vsix，校验完整性后用code --install-extension加--allow-unverified等参数安装，并确保lsp服务器等依赖已离线就绪。
离线安装 VSCode 插件，失败主因不是操作错，而是 .vsix 文件本身不可用、VSCode 版本不匹配、或依赖没到位——装上≠能用。
怎么拿到真正能用的 .vsix 文件
别从 GitHub Release 页面随便下，也别信第三方打包站。官方市场页的 “Download Extension” 按钮生成的是带签名的临时直链，版本和签名都对得上，最稳。
- 打开插件页，例如
https://marketplace.visualstudio.com/items?itemName=ms-python.python - 右侧 Resources 区域点 Download Extension，浏览器直接下载
.vsix - 若需批量或旧版本，用 API 拼 URL：
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension_name}/{version}/vspackage，其中publisher和extension_name要从itemName拆（如ms-python.python→ms-python+python），version必须和 Version History 页面里完全一致（如2026.6.123456） - 下载后用
unzip -t xxx.vsix校验完整性；Windows 用户别右键重命名改后缀，要用Copy-Item复制生成新文件
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 - 路径含空格或中文（如
C:\用户\张三\下载\python.vsix）→ 移到纯英文路径，且 Windows PowerShell 下必须加英文双引号：code --install-extension "C:/vsix/python.vsix" - 装完不显示？先关掉所有 VSCode 实例（包括托盘进程），再重试
装上了却没功能？重点查这三件事
VSCode 对不兼容扩展的处理非常安静：不报错、不提示、只是跳过加载。
- 打开
.vsix解压后的package.json，找"engines": {"vscode": "^1.85.0"}字段；运行code --version，取输出中前两位（如1.118.2→1.118），必须 ≥ 插件要求的最低版本 - 某些插件（如
ms-vscode-remote.remote-ssh）含原生二进制模块，.vsix包里必须有对应平台架构（win32-x64/linux-arm64/darwin-arm64），跨平台拷贝会静默失败 - 插件依赖其他扩展（如
esbenp.prettier-vscode强依赖bradlc.vscode-tailwindcss），只装主插件会导致格式化 Tailwind 类名静默失效；查package.json的extensionDependencies字段，缺啥补啥
语言类插件（Python/Rust/TypeScript）离线后仍不工作？LSP 服务器没离线到位
很多插件安装只是“注册”，首次启用时才下载语言服务器（如 pyright、rust-analyzer、typescript-language-server），这些默认走外网，离线环境会卡在状态栏 “Downloading…” 或输出面板报 spawn ENOENT。
- 正确做法：在有网机器上，用**同版本 VSCode** 安装插件 → 打开一个对应语言的文件（如
test.py）→ 等待 LSP 下载完成并启动成功 → 关闭 VSCode → 找到对应语言服务器缓存目录（如 Windows 下%USERPROFILE%\AppData\Roaming\Code\Cache或插件自己的~/.vscode/extensions/ms-python.python-xxx/out）→ 连同.vsix一起复制到离线机对应位置 - 部分插件支持预配置下载地址（如 Pylance 可在
settings.json中设"python.languageServer": "Pylance"+"python.pylanceDownloadUrl"），但需提前在有网机测试通路
最易被忽略的是：VSCode 1.118 开始，部分 AI 相关插件（如 Copilot）依赖远程令牌服务，即使离线装上，也会因无法连接 copilot.github.com 而禁用核心功能——这类插件本质上不适合纯离线场景。
