IDE识别不到javac或java命令的主因是启动时未加载JAVA_HOME或PATH中的JDK bin目录；需手动配置Project SDK（IntelliJ）、JRE System Library（Eclipse）或java.home（VS Code）。
IDE 识别不到 javac 或 java 命令
这是最常见原因：IDE 启动时没读到系统 JAVA_HOME，或 PATH 中没有 JDK 的 bin 目录。即使终端能运行 java -version，IDE（尤其是 IntelliJ 或 Eclipse）可能用的是自带的启动脚本，不继承 shell 环境变量。
- 检查 IDE 内置终端是否能执行
which javac（macOS/Linux）或where javac（Windows）；如果报“未找到”，说明 IDE 没加载正确环境 - IntelliJ：进入 File → Project Structure → Project → Project SDK，手动点击
+添加本地 JDK 路径（不要选 JRE） - Eclipse：右键项目 → Properties → Java Build Path → Libraries → JRE System Library → Edit…，切换为已安装的 JDK
- VS Code + Extension Pack for Java：确认
java.home设置指向 JDK 根目录（不是bin），例如："java.home": "/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home"
UnsupportedClassVersionError 异常
运行时报错类似 java.lang.UnsupportedClassVersionError: xxx has been compiled by a more recent version of the Java Runtime，本质是编译用的 JDK 版本高于运行时 JVM 版本。
- 检查项目编译级别（如 Maven 的
maven.compiler.source和maven.compiler.target）是否与 IDE 设置的 Language Level、Project SDK、Module SDK 三者一致 - IntelliJ 中：每个模块可能单独设置 SDK，右键模块 → Open Module Settings → Sources → Language level 必须 ≤ 所选 SDK 支持的最高版本
- Maven 项目还需确认
pom.xml中是否显式设了低版本，比如<source>11</source>却用了 JDK 17 编译，会导致 class 文件格式不兼容
IDE 运行配置中 JRE 被错误指定为 JRE 而非 JDK
很多用户下载的是 JRE（仅含 java 运行时），但 IDE 运行程序需要完整的 JDK（含 javac、javadoc、调试工具等）。若运行配置里选了 JRE，编译阶段就直接失败，甚至不报明确错误，只显示 “Build failed” 或空日志。
- IntelliJ：打开 Run → Edit Configurations → Templates → Application → JRE，必须指向 JDK 安装路径（如
/usr/lib/jvm/jdk-17），不能是/usr/lib/jvm/jre-17 - Eclipse：运行配置 → JRE tab → Alternate JRE，下拉列表中应出现带 “jdk” 字样的条目；若只有 “jre”，说明没正确注册 JDK
- VS Code：运行
Java: Configure Java Runtime命令，确保Java Runtime和Java Development Kit都指向同一 JDK 根目录
项目未正确导入为 Java 项目（尤其 Maven/Gradle）
直接打开文件夹而非通过 “Open as Project” 导入，IDE 可能只当普通文本目录处理，不启用 Java 插件、不索引源码、不识别 src/main/java 为源根。
立即学习“Java免费学习笔记（深入）”；
- IntelliJ：关闭项目后，用 Open → 选择 pom.xml 或 build.gradle 文件，勾选 “Import project from external model”
- Eclipse：菜单栏 File → Import → Maven → Existing Maven Projects，选中
pom.xml所在目录 - VS Code：打开含
pom.xml的文件夹后，等待 Java Extension 自动提示 “Import Maven project?”，点 Yes；若没弹出，可手动运行命令Java: Import Projects - 验证方式：项目视图中
src/main/java应显示为蓝色文件夹图标（IntelliJ）或带小圆点包图标（Eclipse），且右键有 “New → Java Class” 选项
最容易被忽略的是：JDK 路径中包含空格或中文字符（比如 C:\Program Files\Java\...），某些旧版 IDE 或构建插件会解析失败，建议重装 JDK 到无空格纯英文路径。
