VS Code配置Java关键在于准确设置java.jdt.ls.java.home和java.configuration.runtimes：前者指定jdt.ls运行的JDK路径（必须为完整JDK，含bin/javac），后者支持多版本项目；路径需转义、禁用中文与空格，且必须重启窗口生效，否则语言服务器无法启动。
新版 VSCode（2026 年稳定版）配置 Java 开发环境，关键不在于“装多少插件”，而在于 java.jdt.ls.java.home 和 java.configuration.runtimes 这两个配置是否准确指向你实际要用的 JDK。只要路径对、版本兼容，补全、跳转、调试、Maven 依赖解析都会自动就位；否则哪怕装了全套扩展，也会卡在“Language Support for Java™ is initializing…”或报 Java home not found。
确认 JDK 版本与安装路径是否真实可用
VSCode 不读取系统 JAVA_HOME 环境变量（除非你显式配置），它只认自己配置里的路径。常见错误是：路径复制粘贴时多了一个空格、用了中文路径、指向了 JRE 而非 JDK、或路径里包含未转义的反斜杠（Windows）。
- 在终端运行
java -version和which java（macOS/Linux）或where java（Windows），确认 JDK 实际位置 - 进入该路径，检查是否存在
bin/javac（Linux/macOS）或binjavac.exe（Windows）——没有这个文件就不是完整 JDK - Windows 用户注意：
"java.home": "C:Program Filesjdk-17"是错的，必须写成"java.home": "C:\Program Files\jdk-17"或用正斜杠"C:/Program Files/jdk-17"
用 settings.json 直接配置 java.home 或 java.jdt.ls.java.home
VSCode 从 1.85 版本起默认优先读取 java.jdt.ls.java.home，而非旧的 java.home。后者已被标记为 deprecated，仅作向后兼容。如果你同时设了两者，以 java.jdt.ls.java.home 为准。
- 打开设置 → 搜索
java.jdt.ls.java.home→ 点击「在 settings.json 中编辑」 - 添加一行（示例 macOS）：
"java.jdt.ls.java.home": "/Library/Java/JavaVirtualMachines/jdk-17.0.2.jdk/Contents/Home" - 如果项目需多 JDK（如 Spring Boot 3.x 要 JDK 17+，但遗留模块要 JDK 8），改用
java.configuration.runtimes，它支持 name/path/default 三元组，且会出现在「Java: Configure Java Runtime」命令菜单中
Java Extension Pack 安装后必须重启窗口，不是重启 VSCode
很多用户点了「重新加载窗口」但没注意 VSCode 弹出的是「Reload Window」还是「Restart Extension Host」——只有前者才真正重载语言服务器。不重启，java.jdt.ls.java.home 配置不会生效，状态栏仍显示「Loading Java language features…」。
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
立即学习“Java免费学习笔记（深入）”；
- 快捷键
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac）→ 输入Developer: Reload Window→ 回车 - 观察右下角状态栏：出现 Java 图标（☕）且显示 JDK 版本号（如 “Java 17”），才算成功启动语言服务器
- 若仍卡住，打开命令面板执行
Java: Show Java Home，它会直接输出当前被加载的 JDK 路径，可立刻验证是否是你预期的那个
导入 Maven/Gradle 项目失败？先检查 .vscode/settings.json 是否覆盖了全局配置
项目根目录下的 .vscode/settings.json 会覆盖用户级 settings.json 中的 java.jdt.ls.java.home。这是双刃剑：适合项目级 JDK 锁定，但也容易导致「明明全局配好了，进项目就报错」。
- 打开项目文件夹后，检查是否存在
.vscode/settings.json，尤其注意里面是否有"java.jdt.ls.java.home"字段 - 如果有，且值为空、错误、或指向一个已卸载的 JDK，则删除该字段或修正路径
- Maven 项目还依赖
maven.executable.path配置，如果本地 Maven 是通过 SDKMAN! 或 Homebrew 安装的，路径可能不是/usr/local/bin/mvn，建议显式指定
最常被忽略的一点：JDK 1.8 支持已在 vscode-java 0.90+ 版本中彻底移除，即使你强行降级插件，也无法获得语义高亮和 LSP 功能。如果必须维护 JDK 8 项目，请用 JDK 11+ 编译运行，仅将源码兼容性设为 --source 8 --target 8，这才是 2026 年的真实工作流。
