离线安装 vscode-java-pack 失败是因为它仅为依赖清单，需手动下载并按顺序安装 redhat.java、vscjava.vscode-java-debug 等所有子扩展 .vsix 文件。
VS Code 报错 “Unable to install extension” 怎么办
离线环境下安装 vscode-java-pack 失败，绝大多数情况不是插件本身有问题，而是 VS Code 没法自动下载依赖项——它会卡在 redhat.java、vscjava.vscode-java-debug 这类子扩展上，因为这些扩展有独立的 .vsix 包和版本约束。
关键点：VS Code 的“离线安装”只支持单个 .vsix 文件，而 vscode-java-pack 是个“扩展包”，本质是清单文件，不带任何实际代码，必须手动凑齐全部依赖。
- 别直接双击官网下载的
vscode-java-pack-*.vsix——它体积小（通常 - 不要试图用
code --install-extension命令只装这个包名，命令行同样会去联网拉依赖 - 真实需要的是：一份完整、版本对齐的扩展集合，包括
redhat.java、gc-excelviewer、ms-vscode.cpptools（可选）等 6–8 个核心子扩展
怎么拿到一整套能离线装的 Java 扩展
最稳的方式是用一台能联网的机器，模拟 VS Code 的安装行为，把所有依赖 .vsix 文件全导出来。不能靠浏览器下载主页链接，因为那些链接指向的是市场页，不是真实包地址。
操作路径很明确：
立即学习“Java免费学习笔记（深入）”；
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 在联网机器上打开 VS Code，装好最新版
vscode-java-pack（让它自动装完所有依赖） - 进设置 → 扩展 → 点右上角
⋯→ 选Export Installed Extensions，生成一个extensions.json - 用脚本或手动从
extensions.json提取每个扩展的 ID 和版本号，拼成下载 URL：https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{name}/{version}/vspackage - 用
wget或浏览器逐个下载，注意替换掉{publisher}（如redhat）、{name}（如java）、{version}（如1.42.0）
常见漏下的包：redhat.vscode-yaml（Java 配置文件高亮依赖）、ms-dotnettools.csharp（如果项目混用 .NET）
离线安装时顺序和参数很重要
VS Code 对扩展依赖有硬性校验，装错顺序会导致报 Extension 'xxx' is not compatible with Code 'x.y.z' 或静默失败。不是所有扩展都能随便装，得按拓扑顺序来。
- 必须先装底层运行时：
redhat.java（提供 Language Server） - 再装调试器：
vscjava.vscode-java-debug、vscjava.vscode-java-test - 最后装包装器：
ms-vscode.vscode-java-pack（它只是把图标和分类组织起来） - 命令行安装务必加
--force参数：code --install-extension redhat.java-1.42.0.vsix --force，否则已存在同名但低版本时会跳过 - Windows 用户注意路径空格：如果 VS Code 装在
C:\Program Files\Microsoft VS Code，要用引号包住整个code路径
装完没语法提示？检查 JAVA_HOME 和 server.status
即使所有扩展都绿色勾选了，Java 项目仍可能不识别——90% 是因为 redhat.java 启动失败，根本没起来。这不是插件问题，是环境链断了。
- 确认系统级
JAVA_HOME指向 JDK 17+（不是 JRE），且%JAVA_HOME%\bin在PATH中 - 在 VS Code 里按
Ctrl+Shift+P，输Java: Show Java Home，看输出是否匹配预期 - 打开命令面板输
Developer: Toggle Developer Tools，切到 Console 标签，搜Starting Java language server，如果卡在Downloading...就说明还在试图联网 -
redhat.java第一次启动会解压java-language-server到%USERPROFILE%\.vscode\extensions\redhat.java-*/server，如果该目录为空或只有lib没有plugins，就是下载被阻断了
真正麻烦的点不在下载步骤，而在于错误信息太笼统：Language server crashed 可能是 JDK 版本不对、内存不够、防病毒软件拦截、甚至临时目录权限不足——得挨个排除，没法一键修复。
