离线安装VSCode插件必须同时满足签名有效、语言服务器就绪、架构与VSCode版本匹配；唯一可靠方式是通过官方直链下载.vsiz，再在联网机预装并完整拷贝扩展目录至离线机。
离线安装 VSCode 插件不是“把文件拷进去就行”，而是必须绕过签名校验、补全语言服务器、对齐架构与 VSCode 版本——漏掉任一环节，插件就只显示在扩展列表里，实际功能全失效。
怎么下载真正能用的 .vsix 文件
第三方镜像站、GitHub Release 页面、浏览器插件生成的链接，90% 拿不到带签名的正确包。唯一稳的方式是走官方直链：
- 打开插件页，例如
https://marketplace.visualstudio.com/items?itemName=ms-python.python，点右侧 Resources →Download Extension：这个按钮生成的是带有效期签名的临时 URL，版本、平台、签名三者全对 - 需要批量或下历史版本？用 API 拼 URL：
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension_name}/{version}/vspackage，其中publisher是 ID 小数点前半段（如ms-python），extension_name是后半段（如python），version必须和 Version History 里完全一致（如2026.6.123456） - 下载后重命名加平台标识，例如
python-2026.6.123456-darwin-arm64.vsix，避免在 M 系列 Mac 上误装 x64 版
拖拽 or 命令行？哪种方式更可靠
拖拽是最稳的 GUI 方式，但失败时几乎全是环境没对齐；命令行适合脚本化，但容错极低：
- 拖拽前提：VSCode 已启动、加载了任意工作区（哪怕空文件夹）、窗口有系统焦点、未全屏、未处于远程连接（RDP/TeamViewer）状态；拖入目标必须是主编辑区域（不是侧边栏、不是设置页）
- 右下角若出现
Extensions disabled by policy，说明企业组策略已禁用扩展安装，此时拖拽和code --install-extension都会静默失败 -
code --install-extension必须用绝对路径，Windows 下含空格或中文路径必须加双引号：code --install-extension "C:/vsix/python.vsix"；Linux/macOS 同样需绝对路径，且code命令必须已注册：在 VSCode 中按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH并执行 - 离线环境下报
INVALID_SIGNATURE？必须加--allow-unverified参数：code --install-extension python.vsix --allow-unverified
装上了却没功能？语言服务器没落地是主因
很多插件（如 ms-python.python、volarjs.volar、esbenp.prettier-vscode）只装 .vsix 只是注册前端，首次启用才下载 LSP 服务（pyright-server、volar-server、prettierCLI）。离线环境卡在 Downloading… 就是这个原因。
- 正确做法：在有网机器上，用同一版本 VSCode 安装该插件 → 打开一个对应类型文件（如
.py或.vue）→ 等状态栏显示Ready→ 把整个~/.vscode/extensions/ms-python.python-2026.6.0/目录（含node_modules和 native 二进制）拷到内网机对应路径下 - 复制完必须彻底退出 VSCode，包括右下角托盘进程，否则缓存不刷新
- ARM Mac 装 x64 插件不会报错，只会静默跳过 native 部分；检查方法：运行
code --version，看 Help → About 里显示的架构；解压 .vsix 后打开package.json，搜索darwin-确认是否含对应平台字段
批量部署时怎么避免漏掉依赖插件
单个插件手动装没问题，但团队部署靠人肉下载容易漏掉隐式依赖——比如装了 esbenp.prettier-vscode 却没装 bradlc.vscode-tailwindcss，格式化功能直接失效。
- 最稳方式：在已配好的联网机器上导出完整列表：
code --list-extensions > extensions.txt，然后逐行用vsce download下载对应 .vsix：vsce download ms-python.python@2026.6.123456 - 别信插件页面写的 “Recommended”：那是推荐栏，不是依赖树；真实依赖藏在 .vsix 解压后的
package.json的extensionDependencies字段里 - 验证版本兼容性：用
unzip -p plugin.vsix package.json | grep engines查插件要求的最低 VSCode 版本，再运行code --version确认本地版本；不匹配就降级插件——去 Marketplace 的/versionhistory页面手动选旧版下载
真正难的不是“怎么装”，而是判断“装完能不能用”：得看状态栏有没有 Ready，Developer: Show Running Extensions 里有没有对应进程，以及关键操作（如格式化、跳转定义）是否响应——这些没法靠扩展面板确认。
