离线安装vscode插件需确保.vsix文件完整、版本兼容，并额外获取lsp服务器等隐式依赖；仅下载.vsix无法启用语言功能，必须在有网同版本vscode中首次激活插件并完整迁移其extensions子目录。
离线安装 VSCode 插件，不能只下 .vsix 文件就完事——尤其在企业内网，装上≠能用，漏掉依赖、版本错配、server 二进制缺失，都会导致语言服务静默失效。
怎么拿到真正可用的 .vsix 文件
直接点 Marketplace 页面上的 “Download Extension” 按钮最稳，但前提是：用无痕窗口 + 登出微软账号后再访问。否则已登录账号可能触发缓存或权限拦截，下载的文件损坏或返回 404。
手动拼 URL 也行，但必须严格按格式：https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension_name}/{version}/vspackage。其中：
-
publisher是插件页右上角 “Publisher” 后的 ID（如ms-python），不是显示名 “Microsoft” -
extension_name是itemName小数点后半段（如ms-python.python→ 填python） -
version必须和页面右侧 “Version History” 栏里标出的数字完全一致（如2024.6.0），多一个空格或少一位都失败
为什么装了 Python / Volar 却没语法高亮
因为这类插件首次启用时会自动拉取原生 server 二进制（如 volar-server 或 pylance-server），离线环境下这个请求卡住，VSCode 不报错、不弹窗，只在状态栏显示 “Starting…”。
解决办法不是重装 .vsix，而是：
- 在有网机器上，用**相同版本的 VSCode** 打开一个对应类型文件（如
.py或.vue） - 等状态栏变绿、右下角出现 “Volar: Ready” 或 “Pylance: Ready”
- 然后完整拷贝整个
~/.vscode/extensions/{publisher}.{extension}-*目录（含server/子目录和可执行文件）到内网机对应路径
只传 .vsix 文件，等于只传了“说明书”，没传“发动机”。
批量安装前必须处理的三个硬性前提
code --install-extension 在企业脚本里跑不通，往往不是命令写错，而是卡在这三处：
-
code命令不可用：不是 PATH 没配，而是 VSCode 安装时没启用 CLI 集成。必须运行Shell Command: Install 'code' command in PATH（通过Ctrl+Shift+P调出） - 已有 GUI 进程在运行：
code --install-extension会尝试复用窗口，导致卡死或静默失败。Windows 脚本开头加taskkill /f /im Code.exe >nul 2>&1，Linux/macOS 加pkill -f "Code Helper" - 签名验证失败：离线环境无法连接微软证书服务器，报
INVALID_SIGNATURE。必须加--allow-unverified参数，如：code --install-extension python.vsix --allow-unverified
如何避免漏掉隐式依赖插件
很多插件不声明显式依赖，但实际运行强依赖其他扩展。例如：
-
esbenp.prettier-vscode看似独立，但若没装bradlc.vscode-tailwindcss，在 Tailwind 类名上格式化会异常 -
ms-python.python默认启用ms-python.pylance，不装它，类型提示和跳转基本失效 -
vue.volar依赖Vue Server，而该 server 又依赖typescript插件提供基础 TS 支持
建议导出当前已验证可用环境的完整列表：code --list-extensions > extensions.txt，再逐个下载，别只凭经验选几个“常用”的。
企业级离线部署最常被忽略的点是：插件能力 ≠ .vsix 文件本身。真正起作用的是解压后目录里的可执行文件、预编译二进制、以及首次激活时生成的缓存结构。离线环境下，这些内容必须提前在同构环境中“触发生成”，再整体迁移。
