Java：maven-compiler-plugin 插件详解

原创已于 2025-06-06 21:40:23 修改 · 5.8w 阅读

82 ·

CC 4.0 BY-SA版权

文章标签：

#maven #java #开发语言

于 2021-10-27 14:39:57 首次发布

Java 专栏收录该内容

21 篇文章

订阅专栏

Maven的maven-compiler-plugin插件用于编译项目代码，其默认JDK版本可能不适用所有项目。通过配置插件的source和target属性，可以指定源码和目标编译的JDK版本，解决版本不匹配导致的编译问题。此外，配置encoding参数可设定编码格式。例如，设置JDK 1.8版本和UTF-8编码的配置如下所示。这样做有助于确保项目在不同环境下编译的一致性。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

maven 是个管理工具，如果我们不告诉它我们的代码要使用什么样的 jdk 版本编译的话，它就会用 maven-compiler-plugin 默认的 jdk 版本来进行处理，这样就容易出现版本不匹配，以至于可能导致编译不通过的问题。

maven 的默认编译使用的 jdk 版本有时候不通用，使用 maven-compiler-plugin 插件可以指定项目源码的 jdk 版本，编译后的 jdk 版本，以及编码。

maven-compiler-plugin

maven-compiler-plugin 插件是一个 Maven 插件，用来编译项目代码；自从3.0开始默认的编译器是 javax.tools.JavaCompiler，用来编译 Java 源码；如果你想强制插件使用 javac 编译器，你必须配置插件的属性 forceJavacCompilerUse；还要注意，当前默认源（source）设置为 1.6，默认目标(target)设置为 1.6。独立运行 Maven 和 JDK，可以通过 source 和 target 选项更改他们的默认值；

1. maven-compiler-plugin插件当前最高版本是3.8.0下载地址：http://mvnrepository.com/artifact/org.apache.maven.plugins/maven-compiler-plugin

2. 插件设置的各种参数信息请查看

http://maven.apache.org/plugins/maven-compiler-plugin/compile-mojo.html#forceJavacCompilerUse

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.0</version>
            <configuration>
                <source>1.8</source>
                <target>1.8</target>
                <encoding>UTF-8</encoding>
            </configuration>
        </plugin>
    </plugins>
</build>

<plugin>
    <!-- 指定maven编译的jdk版本,如果不指定,maven3默认用jdk 1.5 maven2默认用jdk1.3 -->
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.1</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>