VSCode报“JDK not found”主因是未正确识别JDK路径：需确保JAVA_HOME指向JDK根目录（非bin/jre）、java -version与javac -version版本一致，并通过Java: Configure Java Runtime手动添加JDK路径后重启语言服务器。
VSCode 本身不带 Java 运行时，装完 JDK 和插件后仍报 JDK not found 或 java.home 报红，不是 JDK 没装好，而是 VSCode 没读到你真正想用的那个 JDK 路径——尤其当你有多个 JDK 或从终端启动 VSCode 时环境变量不一致，问题会更隐蔽。
确认 JAVA_HOME 和终端输出是否一致
这是最常被跳过的验证步骤。VSCode 的 Java 扩展（redhat.java）依赖系统环境变量做初始探测，但又不完全信任它。
-
java -version和javac -version必须输出**完全一致的版本号**，否则说明JAVA_HOME或PATH没生效 -
JAVA_HOME必须指向 JDK 根目录，不是bin、不是jre，例如：/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home（macOS）、C:\Program Files\Eclipse Adoptium\jdk-17.0.2+8（Windows） - 如果从终端启动 VSCode（比如执行
code .），终端的环境变量会继承过去；如果直接双击图标启动，它读的是系统级环境变量，二者可能不同
用 Java: Configure Java Runtime 手动添加 JDK
比硬改 settings.json 更可靠。VSCode 的 Java 扩展优先读取这个界面配置，而非仅依赖 java.home。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并运行Java: Configure Java Runtime - 在 “JDKs” 标签页里点
Add JDK，直接选中你确认有效的 JDK 根目录（就是上面验证过的那个路径） - 已有多个 JDK 时，勾选你希望项目默认使用的那个，并留意右下角是否出现
Java Language Server is running - 如果之前在
settings.json里写过java.configuration.runtimes，且含已卸载的旧 JDK 路径，删掉它——这类残留会覆盖界面设置
右键 pom.xml → Import to Workspace 是关键动作
VSCode 不会自动把 pom.xml 当作项目入口。只新建文件、放个 pom.xml 是不够的，必须显式触发导入。
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
立即学习“Java免费学习笔记（深入）”；
- 在资源管理器中右键
pom.xml文件，选Import to Workspace（不是 “Open with” 或 “Run as Maven build”） - 观察状态栏右下角：出现
Building workspace→ 完成后显示Java Projects: 1 project才算成功 - 如果弹出
Project configuration is not up-to-date with pom.xml，点通知里的Update project（等效于刷新依赖和 classpath） - 项目用了私有仓库？确保
~/.m2/settings.xml已被加载：用命令面板运行Maven: Change Settings，手动指向它
mvn compile 成功但 VSCode 报红依赖？检查类路径来源
VSCode 的语言服务器不直接复用 mvn compile 的 classpath，它靠自己解析 pom.xml + 缓存 + 项目结构推导，容易卡在中间态。
- 先确认源码目录是否被识别为
src/main/java：右键该文件夹 →Mark Directory as → Sources Root - 检查
.vscode/settings.json是否误加了干扰项，比如错误的java.compile.nullAnalysis.mode或废弃的java.silentConfigValidation - 重启 Java Language Server：命令面板运行
Java: Restart Language Server，比重启 VSCode 更快见效 - 如果刚换过 JDK 版本，旧缓存可能残留，删掉项目根目录下的
.vscode和.project（如有），再重新Import to Workspace
最麻烦的点往往不在 JDK 装没装好，而在于 VSCode 启动方式、环境变量继承、以及“以为导入了其实没真正触发 workspace 构建”这三者叠加——尤其是团队协作时，有人用终端开，有人双击开，java.home 配置就容易变成幻觉。
