IDEA 报错“无效的源发行版”完整解决方案（适用于 JDK 8/11/17/21 等各版本）

在日常 Java 开发中，很多初学者在使用 IDEA 或 Eclipse 编译运行项目时，经常会遇到类似的错误提示：

java: 错误: 无效的源发行版: 8

或者：

java: 错误: 无效的源发行版: 11
java: 错误: 无效的源发行版: 17
java: 错误: 无效的源发行版: 21

那么，这类错误到底是什么意思？该如何解决？本文将带你从原理到实战全面解析。

一、什么是“无效的源发行版”错误？

Java 编译器在编译源码时，会检查 --source 和 --target 选项，确定编译时的 Java 语法版本和生成的字节码版本。

• source：源码兼容的版本（比如 --source 8 代表源码必须符合 Java 8 的语法规则）
• target：字节码生成的版本（比如 --target 8 代表生成的 class 文件兼容 Java 8 的 JVM）

当你使用的 JDK 不支持某个 source 版本 时，就会出现 无效的源发行版 的错误。

举例：

• 使用 JDK 8 编译时设置了 --source 11 → JDK 8 并不认识 Java 11 的语法规则
• 使用 JDK 17 编译时设置了 --source 21 → JDK 17 并没有实现 Java 21 的特性

二、如何解决？

步骤一：确保本地已经安装了对应的 jdk 版本

确保本地已经安装了期望的版本（比如 JDK 8）。如果本地没安装对应的 jdk 版本，先参考这篇文章安装：JDK8 安装教程

步骤二：修改 IDEA 的如下配置

1. 打开 File → Project Structure → Project

2. 打开 File → Project Structure → Modules

3. 打开 File --> Settings–> Build,Execution,Deployment–> Java Compiler;

4. 如果 pom.xml 中指定了 jdk 版本，就将 jdk 版本进行修改，没有指定则不用修改

<properties>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
</properties>

三、不同 JDK 版本支持情况对照表

四、总结

出现 “无效的源发行版” 错误，通常是因为 JDK 版本与项目配置的 source/target 不匹配。
解决思路很简单：

1. 确认你安装了正确的 JDK
2. 在 IDE、Maven 中设置对应的版本号
3. 确保 source 和 target 不超过 JDK 的最高支持范围

掌握了这些技巧，就能轻松避免类似的编译报错。