Maven无真正全局Java编译版本，需在pom.xml中通过properties声明（如maven.compiler.source/ target）或显式配置maven-compiler-plugin插件实现项目级统一；settings.xml配置仅限本地profile，不推荐用于团队协作。
在 Maven 中，没有真正意义上的“全局 Java 编译版本”配置——Maven 本身不维护跨项目的统一 JDK 版本策略，所有 Java 版本控制都基于单个项目（即每个 pom.xml）或用户级 settings（有限影响）。但你可以通过两种主流方式实现“类全局”效果：一种是项目内统一声明（推荐且可靠），另一种是通过 Maven 的 settings.xml 配合 profile 实现多项目复用（需谨慎使用）。
方式一：在 pom.xml 中用 properties 统一声明（最常用、最稳妥）
这是绝大多数团队采用的方式。它把 source 和 target 版本集中定义在 <properties> 中，简洁、可继承、易维护。
- 直接在
pom.xml的<project>标签下添加：
<properties> <maven.compiler.source>17</maven.compiler.source> <maven.compiler.target>17</maven.compiler.target> <maven.compiler.encoding>UTF-8</maven.compiler.encoding> </properties>
无需额外引入插件——Maven 3.8+ 默认启用 maven-compiler-plugin，且会自动读取这些属性。如果你用的是较老版本（如 3.6 或更低），建议显式声明插件版本以避免兼容问题。
方式二：在 pom.xml 中显式配置 compiler 插件（更精细、更可控）
当需要额外控制（如跳过测试编译、启用 verbose 日志、指定 fork JVM 等），或者项目结构复杂（多模块且子模块需差异化配置），推荐显式声明插件。
立即学习“Java免费学习笔记（深入）”；
- 在
<build><plugins>下添加：
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.12.0</version>
<configuration>
<source>17</source>
<target>17</target>
<encoding>UTF-8</encoding>
<fork>true</fork>
</configuration>
</plugin>
注意：<source> 决定能用哪些语言特性（如 record、switch 表达式）；<target> 决定生成的字节码能被哪个 JVM 加载（必须 ≤ 运行时 JDK 版本）。两者通常设为相同值，除非有明确的向下兼容需求（例如源码用 Java 21，但部署到 Java 17 环境）。
方式三：通过 ~/.m2/settings.xml 配置 profile（适用于本地开发环境统一）
这不是项目级配置，而是开发者本地的 Maven 行为定制。适合你有多个独立小项目、不想每个都改 pom.xml 的场景，但不推荐用于团队协作或 CI/CD（因为不可见、难追溯、易冲突）。
- 编辑
~/.m2/settings.xml，在<profiles>中添加：
<profile>
<id>java17-default</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<maven.compiler.source>17</maven.compiler.source>
<maven.compiler.target>17</maven.compiler.target>
</properties>
</profile>
然后确保该 profile 被激活（默认激活即可）。此后，任何未显式覆盖该属性的 Maven 项目都会继承这个设置——前提是项目没在自己的 pom.xml 中重新定义 maven.compiler.* 属性。
验证是否生效
配置完成后，执行以下任一命令并观察输出：
-
mvn compile -X | grep "source version\|target version"（查看 debug 日志中的编译器参数） -
mvn help:effective-pom | grep -A 5 "maven.compiler"（查看最终生效的属性） - 检查编译后的
.class文件：用javap -v target/classes/YourClass.class | grep "major"，结果为 61 → Java 17，64 → Java 20，65 → Java 21，以此类推
只要 source/target 设置一致，且与你本地 JAVA_HOME 指向的 JDK 版本兼容（比如设了 17 就别用 JDK 8 编译），就不会出现 “Unsupported class file major version” 或 “lambda is not supported” 类错误。
