IDEA 报 `-source 16 不支持 switch 模式匹配`？可能是你的 IDEA 版本太老了

一次「Java 21 项目编译报错」的完整排查记录，希望帮后来者少走弯路。

一、问题现象

我新建了一个 Java 21 （第一次使用）的 Spring Boot 项目，用 IDEA 打开后编译报错：

java: -source 16 中不支持 switch 语句中的模式
（请使用 -source 21 或更高版本以启用 switch 语句中的模式）

报错定位到一行用了 Java 21 新增的 switch 模式匹配 的代码：

return switch (xxx) {
case A a -> ...;
case B b -> ...;
};

第一反应很自然：JDK 版本不对，需要装 JDK 21。

二、排查踩坑过程

第 1 步：装 JDK 21（方向对，但没解决）

装上 JDK 21 后，在 Project Structure 里把 Project SDK 切到 21，重新编译——报错依旧。

第 2 步：怀疑编译设置没对齐（绕了弯路）

接下来我花了大量时间在 IDEA 的编译设置里打转：

• Project Structure > Project 的 SDK / Language level
• Settings > Compiler > Java Compiler 的 bytecode version
• Settings > Maven > Runner 的 JRE
• 甚至 File > Invalidate Caches 清缓存

结果 -source 16 报错纹丝不动。

第 3 步：用命令行 Maven 编译，居然成功了

抱着试一试的心态，用命令行编译：

$env:JAVA_HOME = "D:\\develop\\Java\\jdk-21"
$env:Path = "$env:JAVA_HOME\\bin;" + $env:Path
mvn spring-boot:run

居然直接编译运行成功了！

这个反差让我恍然大悟：命令行 Maven 只认 JAVA_HOME，只要指到 JDK 21 就能编译；而 IDEA 编译失败，说明问题出在 IDEA 本身，而不是 JDK 或编译配置。

第 4 步：查 IDEA 版本，真相大白

去查 IDEA 的版本号和用户配置，发现：

• IDEA 版本：IntelliJ IDEA 2021.2（2021 年发布）
• 配置文件 acceptedLanguageLevels.xml 里只接受了 JDK_17

三、根因分析

一句话总结：

IntelliJ IDEA 2021.2 最高只支持 Java 17，而 Java 21 是 2023 年 9 月才发布的，这个老版本 IDEA 根本不认识 Java 21。

这完美解释了之前的所有怪现象：

IntelliJ IDEA 从 2023.3 起才正式支持 Java 21，2021.2 差了整整两年，属于硬性不支持，配置层面怎么改都没用。

四、解决方案

方案 A：升级 IDEA（一劳永逸，推荐）

• 下载新版 IDEA（2023.3 及以上，建议直接最新版）
• 官网：https://www.jetbrains.com/idea/download/
• 新版和旧版可以共存（安装目录、配置目录都独立），不影响老项目

方案 B：命令行 Maven 编译（临时方案）

如果暂时不想升级 IDE，用命令行也能跑：

$env:JAVA_HOME = "D:\\develop\\Java\\jdk-21"
$env:Path = "$env:JAVA_HOME\\bin;" + $env:Path
cd 你的项目目录
mvn spring-boot:run

缺点是少了 IDE 的断点调试等便利。

五、总结：这类问题怎么快速定位

遇到「代码用了新版 Java 语法，但 IDE 报 -source 低版本」时，按下面顺序排查，能少走很多弯路：

我当时跳过了第 2 步，直接从第 1 步跳到第 3 步，结果在编译设置里绕了一个多小时。

核心教训：Java 21 这样的新版本，除了 JDK 本身，你的 IDE、Maven、构建插件都要配套支持，缺一不可。排查时别只盯着一个环节。