先确认命令行中java -version和javac -version均正常输出且版本一致，JAVA_HOME指向JDK根目录；再通过终端启动IDE以继承环境变量；最后在IDE中手动配置JDK路径、清理缓存并检查项目级版本匹配。

环境变量配好了，IDE 还是找不到 JDK，这很常见，但不是环境没配对，而是 IDE 没“看到”它——多数情况是变量没真正生效，或 IDE 自身缓存/启动方式导致配置未被加载。

先确认命令行是否真能用

打开全新终端（不是 IDE 内嵌终端），执行：

• java -version 和 javac -version —— 两个都必须有输出，且版本一致
• echo $JAVA_HOME（macOS/Linux）或 echo %JAVA_HOME%（Windows）—— 输出路径必须指向 JDK 根目录（含 bin、lib、jre 文件夹），不能是 jre 子目录，也不能带 \bin 结尾

如果这里就失败，说明环境变量根本没生效，需检查 PATH 是否包含 %JAVA_HOME%\bin（Windows）或 $JAVA_HOME/bin（macOS/Linux），并确保 shell 配置文件（如 ~/.zshrc）已 source，或 Windows 环境变量已“确定”保存并重启了终端进程。

IDE 启动方式决定它能不能读到变量

IDE 内嵌终端和独立终端继承逻辑不同：内嵌终端是 IDE 的子进程，只继承 IDE 启动时读取的那套环境。所以：

Java注释规范Skills

当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。

下载

• 从开始菜单、Dock 或桌面图标启动的 IDEA/Eclipse/VS Code，往往不加载用户级环境变量
• 正确做法：关闭 IDE，用命令行启动，例如：
  macOS：open -a "IntelliJ IDEA.app"
  Linux：./idea.sh
  Windows：idea.bat（在 IDEA 安装目录 bin 下）

这样启动的 IDE 才会继承当前终端的 JAVA_HOME 和 PATH。

手动指定 JDK 路径，别依赖自动识别

绝大多数 IDE 默认不读系统 JAVA_HOME，必须显式配置：

• IntelliJ IDEA：File → Project Structure → SDKs → + → Add JDK → 选 JDK 根目录（如 C:\Program Files\Java\jdk-17.0.2，不是 bin，也不是 jre）
• Eclipse：Window → Preferences → Java → Installed JREs → Add → Standard VM → JRE home 浏览到 JDK 根目录 → 勾选为默认
• VS Code：设置中搜索 java.home，值填完整 JDK 路径（如 /opt/java/jdk-21），保存后按 Ctrl+Shift+P → “Java: Clean the Java language server workspace”

清缓存、重载项目、检查版本匹配

旧缓存会锁住错误配置，尤其换过 JDK 或升级 IDE 后：

• IntelliJ IDEA：File → Invalidate Caches and Restart → 选 Invalidate and Restart
• Eclipse：Project → Clean… → Clean all projects；右键项目 → Maven → Update Project（若用 Maven）
• 检查项目级设置是否匹配：IDEA 的 Project SDK 和 Module SDK 都要设对；Eclipse 的 Java Compiler compliance level 要与 JDK 版本一致（如 JDK 17 → 17）
• 老版 IDE（如 IDEA 2020.3）可能不支持 JDK 21，查官网 System Requirements，必要时降级 JDK 或升级 IDE