IntelliJ IDEA使用前的Java环境配置指南

IntelliJ IDEA 必须手动配置 JDK 才能正常开发，仅装 JRE 会导致编译失败、符号无法解析；需验证 javac -version、正确设置 JAVA_HOME，并在 Project Structure 中指定 Project SDK 为 JDK 而非 JBR 或 JRE。

IntelliJ IDEA 本身不自带 Java 运行环境，必须手动配置符合要求的 JDK 才能正常编译、运行和调试项目。没配好 JDK，新建项目会报 Cannot resolve symbol 'java.lang.Object'，Maven 导入失败，甚至连新建 .java 文件都标红。

确认系统已安装 JDK 而非 JRE

很多人装了“Java”，但实际只装了 JRE（Java Runtime Environment），它只能运行字节码，不能编译源码。IDEA 需要的是 JDK（Java Development Kit），含 javac、javadoc、jdk.jshell 等开发工具。

• 在终端执行 javac -version，有输出说明 JDK 已安装；若提示命令未找到，大概率只有 JRE
• Windows 用户检查安装路径是否含 jdk-（如 C:\Program Files\Java\jdk-17.0.2），而非 jre1.8.0_351
• macOS 用户推荐用 brew install openjdk@17，避免 Oracle JDK 的许可和更新问题
• Linux 用户注意区分 openjdk-17-jdk（含开发工具）和 openjdk-17-jre（仅运行时）

验证 JAVA_HOME 是否正确设置

虽然 IDEA 可以独立指定 JDK 路径，但很多插件（如 Maven、Gradle、Spring Boot DevTools）依赖 JAVA_HOME 环境变量。设错会导致构建成功但运行时报 UnsupportedClassVersionError。

• 执行 echo $JAVA_HOME（macOS/Linux）或 echo %JAVA_HOME%（Windows），输出应为 JDK 根目录，不是 bin 子目录
• $JAVA_HOME/bin/java -version 和 $JAVA_HOME/bin/javac -version 输出版本号必须一致
• Windows 用户避免路径含空格（如 C:\Program Files\...），建议改用短路径或重装到 C:\jdk17
• macOS 使用 Homebrew 安装后，JAVA_HOME 应设为 /opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk/Contents/Home（ARM）或 /usr/local/opt/openjdk@17/libexec/openjdk.jdk/Contents/Home（Intel）

IDEA 中如何绑定 JDK（Project SDK）

即使系统级 JDK 没问题，IDEA 仍可能默认使用内置的 JBR（JetBrains Runtime），它仅用于启动 IDE，不能编译 Java 项目。

• 首次启动 IDEA 后，新建项目前先打开 File → Project Structure → Project，在 Project SDK 下拉框中选择已安装的 JDK（如 17 (17.0.2)）
• 若下拉列表为空，点 New... → JDK，手动定位到 JDK 安装根目录（选中含 lib、bin、src.zip 的文件夹）
• 不要选 JBR-17 或类似选项——那是 JetBrains 自研的运行时，不支持 javac 编译
• 新建 Maven/Gradle 项目时，IDEA 会自动读取 pom.xml 或 build.gradle 中的 java.version，但前提是 Project SDK 已提前配好，否则模块 SDK 会继承为 none

常见冲突场景与绕过方式

多 JDK 共存是常态，但 IDEA 对版本敏感：JDK 17 编译的类无法在 JDK 11 上运行，而 Kotlin 插件、Lombok、某些 Spring Boot 版本对 JDK 小版本也有硬性要求。

• 项目级覆盖：在 File → Project Structure → Modules 中，为每个模块单独设置 Language level（如 SDK default 或 17-LTS），该设置优先于 Project SDK 的语言特性限制
• Maven 项目需同步 source 和 target：

  <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.11.0</version>
    <configuration>
      <source>17</source>
      <target>17</target>
    </configuration>
  </plugin>

• 遇到 Annotation processor not found（如 Lombok），检查是否勾选了 Settings → Build → Compiler → Annotation Processors → Enable annotation processing，且模块 SDK 是 JDK 不是 JRE
• Mac M1/M2 用户若看到 Could not find tools.jar，说明误选了 JRE 或旧版 JDK；OpenJDK 17+ 已移除 tools.jar，此错误纯属路径指向错误

最易被忽略的一点：IDEA 的 Project SDK 和 Project language level 是两个独立开关。前者决定用哪个 javac 编译，后者决定允许使用的语法糖（比如 var、switch 表达式）。两者不一致时，编辑器会高亮报错，但编译可能通过——这种静默不一致，往往拖到上线才暴露。