IntelliJ IDEA 的 Java 开发环境需精准对齐 JDK、Project SDK、Language Level 和 Module Bytecode Version 四要素；任一错位将导致编译通过但运行报错、Lambda/var 报红或 Maven 构建失败。
IntelliJ IDEA 本身不是“Java IDE 安装与设置解析”这种泛泛而谈的配置任务，而是围绕 jdk、project SDK、language level 和 module bytecode version 四个核心点做精准对齐——错一个，就会出现编译通过但运行报错、Lambda 不识别、var 报红、甚至 Maven 构建失败等现象。
确认系统已安装并正确配置 JDK
IDEA 不自带 JDK，必须提前安装。仅下载 JRE 或使用某些 Linux 发行版自带的 OpenJDK（如 Ubuntu 的 openjdk-11-jre）会导致无法编译 —— 缺少 javac 和 tools.jar。
- 检查终端是否可用：
java -version && javac -version
两者输出版本号必须一致且不报错 - Windows 用户避免用 Oracle 网站下载的 “JDK with JRE” 混合包；推荐使用
jdk-17.0.1或jdk-21这类标准 JDK 安装包 - macOS 用户若用 Homebrew 安装，执行
brew install openjdk@21
后需手动软链：sudo ln -sfn /opt/homebrew/opt/openjdk@21/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk-21.jdk
- Linux 用户注意区分
/usr/lib/jvm/java-17-openjdk-amd64（Debian/Ubuntu）和/usr/lib/jvm/java-17-openjdk（CentOS/RHEL），路径错一个，IDEA 就找不到 SDK
在 IDEA 中正确设置 Project SDK 和 Language Level
这两个设置不在同一位置，但必须语义一致：比如选了 Project SDK: 17，却把 Language level 设成 8，IDEA 会允许写 Stream.of(...).toList()（JDK 16+ 新增），但编译时直接报错 —— 因为 Language level 控制的是语法高亮和代码补全范围，而实际编译由 Maven/Gradle 或 IDEA 内置编译器按 Project bytecode version 执行。
- 设置入口：
File → Project Structure → Project（快捷键Ctrl+Alt+Shift+S） -
Project SDK：点击New… → JDK，指向你本地的jdk-17.0.1根目录（含bin/javac） -
Project language level：下拉选与 SDK 主版本一致的选项，如17 (Preview) - Switch expressions, pattern matching, etc.；若用 JDK 21，选21 (Preview) - Sequenced Collections, Virtual Threads - 别忽略
Project compiler output路径，确保不落在系统临时目录或中文路径中，否则编译产物可能被杀毒软件误删
Maven/Gradle 项目里如何覆盖 IDEA 默认编译级别
即使 IDEA 界面里设好了 JDK 17，如果 pom.xml 没声明 maven-compiler-plugin 版本和源码目标，Maven 构建仍会默认用 JDK 8 字节码（target=1.8），导致运行时报 java.lang.UnsupportedClassVersionError。
立即学习“Java免费学习笔记（深入）”；
- Maven 用户必须显式配置插件（JDK 17 示例）：
org.apache.maven.plugins maven-compiler-plugin 3.11.0 17 17 UTF-8 - Gradle 用户在
build.gradle中加：java { sourceCompatibility = JavaVersion.VERSION_17 targetCompatibility = JavaVersion.VERSION_17 } - IDEA 导入 Maven 项目后，自动读取这些配置并同步到
Settings → Build → Compiler → Java Compiler的Target bytecode version，但首次导入常不同步 —— 需右键项目 →Reload project - 若用 Lombok，还要确认
Annotation Processors已启用（Settings → Build → Compiler → Annotation Processors），否则@Data不生效
常见报错与对应排查点
很多问题表面是 IDEA 报红，根源其实是 JDK、IDEA 设置、构建工具三者之间存在隐性错位。
-
Cannot resolve symbol 'var'：检查Language level是否 ≥ 10，且Project SDK是 JDK 10+（不是 JRE） -
java: package javax.annotation does not exist：JDK 9+ 移除了java.xml.ws.annotation，需添加依赖javax.annotation:javax.annotation-api:1.3.2，而非降级 JDK -
Error:java: invalid source release: 21：IDEA 的Project SDK没设对，或 Maven 插件21但本地只有 JDK 17 - Debug 时断点失效、变量显示
toString() not available：检查Settings → Build → Compiler → Java Compiler → Configure JIT是否勾选了Enable debug info for generated lambda classes（JDK 17+ 默认开启，旧版需手动开）
最易被忽略的是：IDEA 的 Project SDK 和 Module SDK 可以不同，但一旦模块没单独指定 SDK，就继承 Project 级设置；而多人协作时，有人改了模块 SDK 却没提交 .idea/modules.xml，其他人拉代码后就变成“看着一样，实际编译失败”。所以团队应统一用 Maven/Gradle 控制源码级别，并禁用 .idea 下的 SDK 相关配置提交。
