直接在pom.xml中配置maven-compiler-plugin可精准控制源码语法和字节码版本；推荐用替代/以自动约束语法、字节码与启动类路径，避免兼容问题。

直接在 pom.xml 中配置 maven-compiler-plugin，就能明确控制源码语法版本和生成字节码的兼容级别。关键不是换 JDK 路径，而是告诉 Maven “按哪个 Java 规范来读代码、生成 class 文件”。

用 properties 简洁统一指定

适合多模块项目，父 POM 里写一次，所有子模块自动继承：

• 在 <properties></properties> 块中添加两行：

  maven.compiler.source>17
  17

这样就设定了源码支持 Java 17 语法（如 var、sealed 类），且生成的 class 文件能在 JDK 17+ 运行时加载。无需插件声明，Maven 会自动应用默认插件。

用 plugin 配置更精细控制

当需要额外参数（如编码、编译警告、跳过测试）或想显式锁定插件版本时，推荐这种方式：

Java Maven Code Review

审查Java Maven项目（ZIP压缩包或GitLab仓库URL），检查代码规范、命名、模块边界、可维护性问题以及重复代码。

下载

• 在 <build><plugins></plugins></build> 中加入完整插件配置：

  org.apache.maven.plugins
  maven-compiler-plugin
  3.12.0
  
    21
    21
    UTF-8
  

注意：<source></source> 和 <target></target> 通常保持一致；若需向下兼容（比如用 Java 21 写代码但部署到 JDK 17 环境），可设 <source>21</source> + <target>17</target>，但源码中不能使用 JDK 17 之后才引入的 API。

为什么改了不生效？常见原因

配置写对了，但 IDE 或命令行仍报错旧版本，往往卡在这几个环节：

• IDE（如 IntelliJ/Eclipse）没刷新 Maven 项目：右键项目 → Maven → Reload project（IntelliJ）或 Update project（Eclipse）
• 本地 JAVA_HOME 指向低版本 JDK：Maven 编译器插件虽指定了 source/target，但底层仍调用 $JAVA_HOME/bin/javac；若 source=21 但 JAVA_HOME 是 JDK 8，会直接编译失败
• 同时存在 properties 和 plugin 配置：后者优先级更高，但若插件未声明 <configuration></configuration>，可能回退到 properties 或默认值

进阶：绑定具体 JDK 路径（非必须）

多数场景只需 source/target；真要强制用某路径下的 JDK（比如机器上装了 JDK 8/17/21，而当前 JAVA_HOME 是 8），可用 toolchains.xml + maven-toolchains-plugin，或在 plugin 中加：

  true
  /path/to/jdk21/bin/javac

但需确保 fork=true，否则 executable 不生效。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南