Maven编译插件版本配置指南

在Maven中配置编译插件版本需根据目标JDK版本调整，以下是针对Java 8/11/17的配置方法：

1. 配置原理

• 使用maven-compiler-plugin控制编译过程
• 关键参数：
  • <source>：源代码兼容版本
  • <target>：生成字节码版本
  • <release>(Java 9+)：同时控制源码/字节码及API访问

2. Java 8配置

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-compiler-plugin</artifactId>
      <version>3.8.1</version> <!-- 兼容Java8的最新稳定版 -->
      <configuration>
        <source>1.8</source>
        <target>1.8</target>
        <!-- 可添加编译器参数 -->
        <compilerArgs>
          <arg>-Xlint:all</arg>
        </compilerArgs>
      </configuration>
    </plugin>
  </plugins>
</build>

3. Java 11配置

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-compiler-plugin</artifactId>
  <version>3.11.0</version> <!-- 支持Java11+特性 -->
  <configuration>
    <release>11</release> <!-- 推荐使用release参数 -->
    <!-- 或传统方式 -->
    <!-- <source>11</source> -->
    <!-- <target>11</target> -->
  </configuration>
</plugin>

4. Java 17配置

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-compiler-plugin</artifactId>
  <version>3.11.0</version> <!-- 最低要求3.10.0 -->
  <configuration>
    <release>17</release> <!-- 支持密封类/模式匹配等特性 -->
    <showWarnings>true</showWarnings>
  </configuration>
</plugin>

5. 多版本兼容配置技巧

<properties>
  <!-- 通过Maven属性动态控制版本 -->
  <java.version>17</java.version>
  <compiler.version>3.11.0</compiler.version>
</properties>

<plugin>
  <version>${compiler.version}</version>
  <configuration>
    <release>${java.version}</release>
  </configuration>
</plugin>

6. 验证配置

执行编译命令检查配置效果：

mvn clean compile -X | grep "Source target"

预期输出示例：

[DEBUG] Source: 17, target: 17

7. 注意事项

1. 插件版本对照表：

   JDK版本	最低插件版本	推荐版本
   8	3.6.0	3.8.1
   11	3.8.0	3.11.0
   17	3.10.0	3.11.0

2. 使用<release>替代<source>/<target>的优势：

   • 避免-source和-target的已知问题
   • 确保使用正确的平台API
   • 自动包含模块系统配置

3. 多模块项目应在父POM中统一配置，确保编译环境一致性

最佳实践：始终使用最新稳定版插件（当前3.11.0），并通过<release>参数指定目标JDK版本，可最大化兼容性和新特性支持。