最可靠方式是直接在项目级.vscode/settings.json中配置java.home为jdk根路径（含lib/modules等），并同步设置java.configuration.runtimes声明兼容版本，否则将导致“cannot resolve jdk”、无补全、跳转失效等问题。
直接指定 java.home 是最可靠的方式
VSCode 的 Java 扩展（Language Support for Java™ by Red Hat）启动语言服务器时，优先读取 java.home 配置项。它必须是 JDK 安装目录的**根路径**（不是 bin 子目录），且该路径下必须包含 lib/rt.jar（Java 8）或 lib/modules（Java 9+）等关键文件。
错误现象：编辑器报错“Cannot resolve JDK”、代码无补全、Ctrl+Click 跳转失效——大概率是 java.home 指向了 JRE、错误子目录，或权限不足。
-
java.home必须写在项目级.vscode/settings.json中，而非用户全局设置，否则无法实现项目隔离 - 路径中含空格（如 Windows 的
C:Program FilesJava...）无需引号，但需确保路径真实存在且可读 - macOS 上典型路径是
/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home，别漏掉末尾的/Home
java.configuration.runtimes 控制编译与运行时兼容性
仅设 java.home 不足以让 Maven/Gradle 构建按预期版本执行。比如项目用 Java 17 编写，但 pom.xml 中 <java.version>21</java.version>，此时需要显式声明可用运行时。
该配置告诉 Java 扩展：“这个项目允许用哪些 JDK 版本来编译和运行”，并影响 javac 参数（如 -source 和 -target）的自动推导。
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 必须与
java.home指向的 JDK 版本匹配，否则扩展可能忽略该条目 - 数组中每个对象的
name字段要严格对应 JDT LS 内部标识，常见值："JavaSE-11"、"JavaSE-17"、"JavaSE-21" - 如果项目需同时支持多个目标版本（如发布 Java 11 和 Java 17 兼容包），此处只声明“可用 JDK”，具体编译版本仍由构建工具（Maven/Gradle）控制
Maven 终端不继承 java.home？得配 maven.terminal.customEnv
你在 VSCode 里点 Maven 插件按钮（如 clean install）时，它会新开一个终端并自动注入环境变量；但如果你用 Ctrl+` 手动打开集成终端，它默认只读系统 JAVA_HOME，完全无视 .vscode/settings.json。
结果就是：编辑器里代码不报错，但终端跑 mvn compile 却提示 “Unsupported class file major version 61”——因为终端用了旧 JDK。
- 在
.vscode/settings.json中添加maven.terminal.customEnv，显式覆盖终端的JAVA_HOME - 值必须是字符串，不能是变量引用；例如：
"value": "C:\Program Files\Java\jdk-21" - 该配置只影响通过 Maven 插件触发的终端；普通终端仍需手动
export JAVA_HOME=...或靠 SDKMAN! 切换
切换 JDK 时最容易被忽略的三个地方
改完 settings.json 并不等于生效。VSCode Java 扩展有缓存机制，且部分状态依赖进程重启。
- 修改后必须点击右下角 Java 图标 → “Reload Project”，或手动关闭再打开文件夹，否则语言服务器仍用旧 JDK 加载类路径
- 调试时用的 JDK 由
.vscode/launch.json中的vmArgs或java.executable决定，和java.home无关；老项目常漏配此项，导致断点进不去 - 如果项目含
module-info.java，JDK 版本还影响模块解析行为（如requires java.desktop在 Java 11+ 才有效），此时仅靠java.home不够，必须确认java.configuration.runtimes已声明对应版本
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
