IntelliJ IDEA 报错 java:无效的源发行版 21 解决方案
该错误通常发生在 IntelliJ IDEA 中,当项目配置的 Java 源版本(例如 Java 21)与当前环境不匹配时。常见原因包括:Java 21 未安装、IDEA 项目设置错误、或构建工具(如 Maven/Gradle)配置不一致。
步骤 1: 检查 Java 安装
首先,确认您的系统已安装 Java 21(JDK 21)。如果未安装,需下载并安装。
- 下载地址:Oracle JDK 21 或 OpenJDK 21
- 安装后,重启 IDEA 并重新加载项目。
常见问题:如果已安装但版本不匹配,尝试设置环境变量 JAVA_HOME 指向 JDK 21 的安装路径(例如:C:\Program Files\Java\jdk-21)。
Windows/Linux/macOS 检查方法: 打开终端(或命令提示符),输入以下命令:
java -version
如果输出显示类似 openjdk version "21",则表示已安装。否则,需下载 JDK 21。
步骤 2: 配置 IntelliJ IDEA 项目设置
在 IDEA 中,确保项目语言级别和模块语言级别设置为 Java 21。
-
配置项目结构:
- 菜单栏:File > Project Structure。
- 在 Project Settings 下,选择 Project。
- 设置 Project SDK 为 Java 21(如果未列出,点击 New… 添加 JDK 21 路径)。
- 设置 Project language level 为 21 - Modules, records, patterns, etc.(对应 Java 21)。
-
配置模块设置:
- 在 Project Structure 窗口中,选择 Modules。
- 选择您的模块(如
main),在 Sources 标签下,设置 Language level 为 21。 - 点击 Apply 保存。
-
检查编译器设置:
- 菜单栏:File > Settings(或 Preferences on macOS)。
- 导航到 Build, Execution, Deployment > Compiler > Java Compiler。
- 确保 Project bytecode version 和模块的 Target bytecode version 都设置为 21。
- 点击 OK 保存。

