vscode 依赖 java 扩展管理 jdk，需同时配置 java.home（指定语言服务器 jdk）和 java.configuration.runtimes（定义编译/运行时选项），二者缺一不可；修改后必须重启 java language server 才生效。
VSCode 本身不管理 JDK，它依赖 Java 扩展（Red Hat 提供）来识别、加载和切换 JDK。项目级隔离是可行的，但必须明确配置点——java.home 控制语言服务器启动用的 JDK，java.configuration.runtimes 定义编译/运行时可选项，两者缺一不可。
vscode settings.json 中必须配齐两个关键字段
只设 java.home 不够，会导致 Maven 编译或运行时仍用错版本；只设 java.configuration.runtimes 不指定 java.home，则编辑器语法校验、补全可能失效。二者需协同生效：
-
java.home必须指向一个完整 JDK 目录（含bin/javac），不是 JRE，也不是jdk-17/bin这种末端路径 -
java.configuration.runtimes是数组，每个元素含name（如"JavaSE-17"）和path（同java.home格式），建议显式加"default": true标出主版本 - Windows 路径中的反斜杠要写成双反斜杠：
"C:\Program Files\Java\jdk-17"，单斜杠或正斜杠都可能被忽略 - macOS 的典型路径是
/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home，别漏掉/Contents/Home
切换 JDK 时命令面板和 settings.json 同步更新
用 Ctrl+Shift+P → Java: Configure Java Runtime 点选版本后，VSCode 会自动写入 .vscode/settings.json。但注意：
- 该操作只影响当前工作区（即打开的文件夹），不会改全局设置或系统
JAVA_HOME - 如果项目里已有
pom.xml或build.gradle，且其中指定了sourceCompatibility = "1.8"，VSCode 可能自动降级语言功能，此时需手动在settings.json中把java.configuration.runtimes里的name改为"JavaSE-1.8"并设为default - 改完保存后，必须重启 Java Language Server：右键任意
.java文件 →Java: Check Language Server Status，确认输出中java.home路径已更新
多项目混用时别依赖系统 JAVA_HOME
系统级 JAVA_HOME 对 VSCode 项目无强制约束力，但会干扰终端内 java -version 结果，造成“编辑器显示 JDK 17，终端却报 JDK 8”的错觉：
- Windows 用户务必删掉 Path 中 Oracle 自动加的
C:Program FilesCommon FilesOracleJavajavapath，否则java命令永远走这个软链接，和 VSCode 配置脱节 - macOS/Linux 推荐用
jenv管理 shell 级 JDK，它通过.java-version文件实现目录感知，与 VSCode 的settings.json并行不冲突 - 若用 Scoop（Windows）或 SDKMAN!（Linux/macOS），确保它们修改的是
PATH，而非覆盖JAVA_HOME——VSCode 读取java.home优先于环境变量
最容易被忽略的是：VSCode 的 Java 扩展不会主动监听 settings.json 变更并热重载 JDK。每次改完必须手动触发语言服务器重启，否则你看到的错误提示、语法高亮、甚至跳转定义，都还卡在旧版本上。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
