Maven中配置maven-compiler-plugin 插件和jdk 17版本

如何修改Maven工程的JDK版本

修改项目中的pom.xml文件，添加maven-compiler-plugin插件3.8.1版本，指定JDK的编译版本为Java 17，简约版配置信息如下：

<build>
    <plugins>
        <!-- 配置当前项目的jdk版本信息 -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version>
            <configuration>
                <source>17</source>
                <target>17</target>
                <encoding>UTF-8</encoding>
            </configuration>
        </plugin>
    </plugins>
</build>

然后update maven project，即可获得指定JDK 17版本，此方法适用于修改单个工程的JDK版本。如果想进行全局设置，请移步本文第三节。

maven-compiler-plugin插件详解

maven是个项目管理工具，如果不告诉它代码要使用什么样的jdk版本编译，它就会用编译插件maven-compiler-plugin默认的jdk版本来处理，这样就容易出现版本不匹配的问题，以至于可能导致编译不通过的问题。例如代码中若使用了Java 8的新特性，比如函数式编程，但是maven在编译的时候使用的是Java 7，那这一段代码是完全不可能编译成.class文件的。为了避免出现这种情况，在构建maven项目的时候，我习惯性第一步就是配置maven-compiler-plugin插件，指定项目源码的 jdk 版本，编译后的 jdk 版本，以及编码方式。

从 maven-compiler-plugin 3.8.0 之后，默认JDK 版本就由 1.5 改为 1.6 了。但是这仍然跟不上 JDK 的更新速度，目前大多数系统都在使用 JDK 1.8。Apache Maven Project 对 maven-compiler-plugin中compiler:compile有如下关于jdk版本变更的描述：

详细配置：

 <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.8.0</version>
    <configuration>
        <!-- 一般而言，target与source是保持一致的，但是，有时候为了让程序能在其他版本的jdk中运行(对于低版本目标jdk，源代码中不能使用低版本jdk中不支持的语法)，会存在target不同于source的情况 -->                    
        <source>1.8</source> <!-- 源代码使用的JDK版本 -->
        <target>1.8</target> <!-- 需要生成的目标class文件的编译版本 -->
        <encoding>UTF-8</encoding><!-- 字符集编码，防止中文乱码 -->
            <skipTests>true</skipTests><!-- 跳过测试 -->
            <verbose>true</verbose>
            <showWarnings>true</showWarnings>
            <fork>true</fork><!-- 要使compilerVersion标签生效，还需要将fork设为true，用于明确表示编译版本配置的可用 -->
            <executable><!-- path-to-javac --></executable><!-- 使用指定的javac命令，例如：<executable>${JAVA_1_4_HOME}/bin/javac</executable> -->
            <compilerVersion>1.3</compilerVersion><!-- 指定插件将使用的编译器的版本 -->
            <!-- 这下面的是可选项 -->
            <meminitial>128m</meminitial><!-- 编译器使用的初始内存 -->
            <maxmem>512m</maxmem><!-- 编译器使用的最大内存 -->
            <compilerArgument>-verbose -bootclasspath ${java.home}\lib\rt.jar</compilerArgument><!-- 这个选项用来传递编译器自身不包含但是却支持的参数选项 -->
        </configuration>
    </plugin>

修改maven的settings.xml文件

此种设置方式将影响由maven创建的所有项目。找到maven安装目录的conf文件夹，修改其中的settings.xml文件，在profiles标签加入如下配置：

<!-- ${MAVEN_HOME}/conf/settings.xml 文件添加如下profile配置，建立的java项目默认使用java 17 -->
<profiles>
    <profile>
        <id>jdk-17</id>
        <activation>
            <activeByDefault>true</activeByDefault>
            <jdk>17</jdk>
        </activation>
        <properties>
            <maven.compiler.source>17</maven.compiler.source>
            <maven.compiler.target>17</maven.compiler.target>
            <maven.compiler.compilerVersion>17</maven.compiler.compilerVersion>
        </properties>
    </profile>
</profiles>

这样全局设置后，项目编译时就会默认使用java 17。全局配置的好处就是省事、方便，从而避免对每个项目都去设置。由于很多项目依然在使用java 8，故下面提供一下设置java 8的方法：

<profile>    
    <id>java-8</id>    
    <activation>    
        <activeByDefault>true</activeByDefault>    
        <jdk>1.8</jdk>    
    </activation>    
    <properties>    
        <maven.compiler.source>1.8</maven.compiler.source>    
        <maven.compiler.target>1.8</maven.compiler.target>    
        <maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>    
    </properties>    
</profile>