VSCode需手动配置java.home指向完整JDK根目录，因其Java插件不读取系统PATH或JAVA_HOME；必须重启VSCode并使用Java: Configure Java Runtime添加JDK路径，否则即使java -version成功也会报“JDK not found”。
VSCode 本身不带 Java 运行环境，java 和 javac 命令能跑不代表 VSCode 能用——必须手动指定 java.home 指向完整 JDK 根目录，否则连 public class 都标红、调试器启动失败。
为什么 java -version 成功但 VSCode 仍报 “JDK not found”
常见错误是混淆了“系统可用”和“VSCode 可见”。VSCode 的 Java 插件（如 redhat.java）不读取 JAVA_HOME 或 PATH，它只认显式配置的路径。即使终端里 java -version 和 javac -version 都返回 17 或 21，VSCode 仍可能卡在 “Loading Java Projects…”。
- 别用 macOS 自带
/usr/bin/java：它通常是 JRE，没javac，也没调试支持 - 别把
java.home设成bin目录（如/jdk-17/bin）或jre子目录——必须是含lib/、bin/、jre/的根目录 - Windows 用户注意路径分隔符：
"java.home": "C:\Program Files\Eclipse Adoptium\jdk-17.0.12+7"或用正斜杠"C:/Program Files/Eclipse Adoptium/jdk-17.0.12+7"
Java: Configure Java Runtime 比硬写 java.home 更可靠
直接编辑 settings.json 写死 "java.home": "...” 在多 JDK 场景下容易失效，尤其当你切换项目时。VSCode 的 Java 扩展优先读取命令面板里管理的 JDK 列表。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并选择Java: Configure Java Runtime - 在 “JDKs” 标签页点
+→ 浏览到 JDK 根目录（例如/Library/Java/JavaVirtualMachines/jdk-21.0.3+9.jdk/Contents/Home） - 确认后，状态栏右下角应立刻显示
21或17；若仍显示Not found，检查目录权限（macOS/Linux 执行ls -ld确认可读） - 该操作会自动更新工作区
.vscode/settings.json，生成带java.configuration.runtimes的配置，比单个java.home更健壮
重启 VSCode 是硬性要求，不是建议
改完 java.home 或执行过 Java: Configure Java Runtime 后，不重启 VSCode，插件仍加载旧缓存。你会看到状态栏没变化、Ctrl+Click 跳不到 JDK 类源码、断点无法命中。
立即学习“Java免费学习笔记（深入）”；
- 关闭所有 VSCode 窗口（包括后台进程），再重新打开
- 验证方式：新建一个
Test.java，输入public class Test {，看左下角是否显示 JDK 版本号；再按Ctrl+Shift+P输入Java: Configure Classpath，能正常弹出对话框才算生效 - 如果用了 Maven，仅配置 JDK 不够：还需单独设
maven.executable.path指向mvn或mvn.cmd文件本身，不能指向bin目录
最容易被忽略的是：JDK 路径必须精确到 Contents/Home（macOS）、jdk-x.x.x（Windows/Linux），且该目录下必须存在 lib/rt.jar（JDK 8）或 lib/modules（JDK 9+）。少一个文件，语言服务器就起不来。
