在 Maven 中指定 Java 版本 - 属性和编译器插件之间的差异

java maven maven-3 maven-compiler-plugin

我对 Maven 不是很有经验，在尝试多模块项目时，我开始想知道如何为父 Maven pom 中的所有子模块指定 Java 版本。直到今天我只使用：

<properties>
    <java.version>1.8</java.version>
</properties>

...但是在研究时我发现您还可以在 Maven 编译器插件中指定 Java 版本，如下所示：

<plugins>
    <plugin>    
        <artifactId>maven-compiler-plugin</artifactId>
        <configuration>
            <source>1.8</source>
            <target>1.8</target>
        </configuration>
    </plugin>
</plugins>

然后将其包装到插件管理标签中以启用子 poms 的使用。所以第一个问题是这样的：

在属性和 Maven 编译器插件中设置 Java 版本有什么区别？

我找不到明确的答案，但在研究过程中我发现您也可以通过这种方式指定 Java 版本：

<properties>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
</properties>

...这表明即使我没有明确声明它也存在编译器插件。运行 mvn package 输出

maven-compiler-plugin:3.1:compile (default-compile) @ testproj ---

...以及我没有声明的其他一些插件。

那么这些插件是 Maven pom 的默认隐藏部分吗？在属性和 Maven 插件配置元素中设置源/目标之间有什么区别吗？

其他一些问题是 - 应该使用哪种方式（如果它们不相等，何时使用）？哪一个最适合多模块项目，如果 pom 中指定的 Java 版本与 JAVA_HOME 中指定的版本不同，会发生什么？

相关：“maven.compiler.release” as an replacement for source and target?

相关：How do you specify the Java compiler version in a pom.xml file?

armandino

如何指定JDK版本？

使用以下三种方式中的任何一种：(1) Spring Boot 功能，或将 Maven 编译器插件与 (2) source & target 或 (3) 与 release。

弹簧靴

在 Maven 文档中没有被引用。这是 Spring Boot 的特殊性。它允许将源和目标 java 版本设置为相同的版本，例如这个为两者指定 java 1.8：1.8

如果您使用 Spring Boot，请随意使用它。

带有源和目标的 maven-compiler-plugin

使用 maven-compiler-plugin 或 maven.compiler.source/maven.compiler.target 属性是等效的。

那确实是：

<plugins>
    <plugin>    
        <artifactId>maven-compiler-plugin</artifactId>
        <configuration>
            <source>1.8</source>
            <target>1.8</target>
        </configuration>
    </plugin>
</plugins>

相当于：

<properties>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
</properties>

根据 Maven documentation of the compiler plugin，因为编译器配置中的 <source> 和 <target> 元素使用属性 maven.compiler.source 和 maven.compiler.target（如果已定义）。

资源

Java 编译器的 -source 参数。注意：自 3.8.0 起，默认值已从 1.5 更改为 1.6。自 3.9.0 起，默认值已从 1.6 更改为 1.7 默认值为：1.7。用户属性是：maven.compiler.source。

目标

Java 编译器的 -target 参数。注意：自 3.8.0 起，默认值已从 1.5 更改为 1.6。自 3.9.0 起，默认值已从 1.6 更改为 1.7 默认值为：1.6。用户属性是：maven.compiler.target。

关于 source 和 target 的默认值，请注意 since the 3.8.0 of the maven compiler, the default values have changed from 1.5 to 1.6。

maven-compiler-plugin 与发布而不是源和目标

maven-compiler-plugin 3.6 及以后的版本提供了一种新的方式：org.apache.maven.plugins maven-compiler-plugin 3.8.0 9

您也可以声明：

<properties>
    <maven.compiler.release>9</maven.compiler.release>
</properties>

但目前它不会起作用，因为您使用的 maven-compiler-plugin 默认版本不依赖于足够新的版本。

Maven release 参数传达 release ：我们可以从 Java 9 传递的 new JVM standard option ：

针对特定 VM 版本的公共、受支持和记录的 API 进行编译。

这种方式提供了一种为 source、target 和 bootstrap JVM 选项指定相同版本的标准方式。
请注意，指定 bootstrap 是交叉编译的好习惯，它不会如果您也不进行交叉编译，则会受到伤害。

指定 JDK 版本的最佳方法是什么？

仅当您使用 Spring Boot 时才允许使用第一种方式 (<java.version>)。

对于 Java 8 及以下版本：

关于其他两种方法：使用 maven-compiler-plugin 评估 maven.compiler.source/maven.compiler.target 属性或，您可以使用其中一种。它没有改变任何事实，因为最终这两种解决方案依赖于相同的属性和相同的机制：maven 核心编译器插件。

好吧，如果您不需要在编译器插件中指定除 Java 版本之外的其他属性或行为，那么使用这种方式更有意义，因为这样更简洁：

<properties>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
</properties>

从 Java 9 开始：

release 参数（第三点）是一种强烈考虑是否要对源和目标使用相同版本的方法。

如果 JAVA_HOME 中的 JDK 与 pom.xml 中指定的版本不同，会发生什么情况？

如果 JAVA_HOME 引用的 JDK 与 pom 中指定的版本兼容，这不是问题，但为了确保更好的交叉编译兼容性，请考虑添加 bootstrap JVM 选项，并将 {3 的路径作为值target 版本的 }。

需要考虑的重要一点是 Maven 配置中的 source 和 target 版本不应优于 JAVA_HOME 引用的 JDK 版本。
旧版本的 JDK 无法使用更高版本进行编译最新版本，因为它不知道其规范。

根据使用的 JDK 获取有关源、目标和发布支持版本的信息，请参阅java compilation : source, target and release supported versions。

如何处理JAVA_HOME引用的JDK与pom中指定的java目标和/或源版本不兼容的情况？

例如，如果您的 JAVA_HOME 引用 JDK 1.7，并且您在 pom.xml 的编译器配置中指定 JDK 1.8 作为源和目标，这将是一个问题，因为如前所述，JDK 1.7 不知道如何
从它的角度来看，它是一个未知的JDK版本，因为它是在它之后发布的。
在这种情况下，您应该配置Maven编译器插件以通过这种方式指定JDK：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <configuration>
        <source>1.8</source>
        <target>1.8</target>
        <compilerVersion>1.8</compilerVersion>      
        <fork>true</fork>
        <executable>D:\jdk1.8\bin\javac</executable>                
    </configuration>
</plugin>

您可以在 examples with maven compiler plugin 中获得更多详细信息。

它没有被问到，但可能更复杂的情况是您指定源而不是目标。它可能会根据源版本在目标中使用不同的版本。规则是特殊的：您可以在 the Cross-Compilation Options part 中了解它们。

为什么在执行 Maven package 目标时在输出中跟踪编译器插件，即使您没有在 pom.xml 中指定它？

为了编译你的代码并且更普遍地执行 Maven 目标所需的所有任务，Maven 需要工具。因此，它使用核心 Maven 插件（您可以通过其 groupId : org.apache.maven.plugins 识别核心 Maven 插件）来完成所需的任务：用于编译类的编译器插件，用于执行测试的测试插件等等......所以，即使您不声明这些插件，它们也会绑定到 Maven 生命周期的执行。
在您的 Maven 项目的根目录中，您可以运行命令：mvn help:effective-pom 以有效使用最终的 pom。在其他信息中，您可以看到 Maven 附加的插件（在您的 pom.xml 中指定或未指定）、使用的版本、它们的配置以及生命周期每个阶段的执行目标。

在 mvn help:effective-pom 命令的输出中，您可以在 <build><plugins> 元素中看到这些核心插件的声明，例如：

...
<plugin>
   <artifactId>maven-clean-plugin</artifactId>
   <version>2.5</version>
   <executions>
     <execution>
       <id>default-clean</id>
       <phase>clean</phase>
       <goals>
         <goal>clean</goal>
       </goals>
     </execution>
   </executions>
 </plugin>
 <plugin>
   <artifactId>maven-resources-plugin</artifactId>
   <version>2.6</version>
   <executions>
     <execution>
       <id>default-testResources</id>
       <phase>process-test-resources</phase>
       <goals>
         <goal>testResources</goal>
       </goals>
     </execution>
     <execution>
       <id>default-resources</id>
       <phase>process-resources</phase>
       <goals>
         <goal>resources</goal>
       </goals>
     </execution>
   </executions>
 </plugin>
 <plugin>
   <artifactId>maven-compiler-plugin</artifactId>
   <version>3.1</version>
   <executions>
     <execution>
       <id>default-compile</id>
       <phase>compile</phase>
       <goals>
         <goal>compile</goal>
       </goals>
     </execution>
     <execution>
       <id>default-testCompile</id>
       <phase>test-compile</phase>
       <goals>
         <goal>testCompile</goal>
       </goals>
     </execution>
   </executions>
 </plugin>
  ...

您可以在 the introduction of the Maven lifeycle in the Maven documentation 中获得有关它的更多信息。

不过，当您想将这些插件配置为其他值作为默认值时（例如，当您在 pom.xml 中声明 maven-compiler 插件以调整要使用的 JDK 版本时，您可以声明这些插件）或当您想要添加一些在 Maven 生命周期中默认不使用的插件执行。

感谢您的广泛解释，现在对我来说更清楚了。还有关于 <java.version> - 我在一些代码片段中看到了这一点，也许那是一些自定义属性，我错误地认为这是声明 java 版本的方式，从现在开始将坚持使用 <maven.compiler.x> 属性。

“如果您的 JAVA_HOME 的 JDK 与 pom 中的指定版本兼容，这不是问题”这不是（必然）正确，请查看 this Stack Overflow 线程以供参考

@Robin A. Meade 感谢您的反馈。我使用弹簧靴，但我不知道。就我个人而言，我认为它不够标准，无法用作或引用为可以使用的东西。 Spring Boot 提供了一些非常有趣的东西，但在某些情况下，它的特性非常可争议。覆盖标准 maven 属性的名称以不填充源 jdk 和目标 jdk 看起来确实是一个坏主意，因为它是为应用程序执行一次的。您失去了在应用程序中保留简单 xml 行的标准。哇！什么主意……

@MasterJoe2 您可以在 10 版本的官方 javac 文档中找到它：docs.oracle.com/javase/10/tools/javac.htm#JSWOR627。我把这个答案分成了两部分，因为它变得太大了，你也可以看看：stackoverflow.com/questions/51692748/…

太棒了，描述性很强。谢谢！

Sebastian D'Agostino

上述解决方案都没有立即对我有用。所以我按照以下步骤操作：

在 pom.xml 中添加：

<properties>
    <maven.compiler.target>1.8</maven.compiler.target>
    <maven.compiler.source>1.8</maven.compiler.source>
</properties>

转到 Project Properties > Java Build Path，然后删除指向 JRE1.5 的 JRE System Library。强制更新项目。

您为 Java 10 及更高版本指定哪个版本？是 10 还是 1.10 ？

@MasterJoe2 从 java 9 及以上版本您需要按原样写版本号（ 10 ），对于以下版本，您必须在版本前面添加 1.（ 1.5)

Shivang Agarwal

以下步骤对我来说就像魅力一样！所以想和大家分享。

这些是我在 pom.xml 文件中添加的用于处理基本项目的行。我正在使用 Java 12（您可以替换您的 11、10、1.8 等）。

<properties>
    <maven.compiler.source>12</maven.compiler.source>
    <maven.compiler.target>12</maven.compiler.target>
</properties>
<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version>
            <configuration>
                <release>12</release>
            </configuration>
        </plugin>
    </plugins>
</build>

更改 pom 文件后，请重新加载您的项目，以便 IDE 可以将插件下载/获取到项目中。（对于 IntelijIDEA：右键单击 pom.xml -> 转到 maven -> 重新加载项目）。

请确保也在您的 IDE 中配置所需的版本。

afshar

如果您使用的是 IntelliJ idea maven build。

https://i.stack.imgur.com/hrSLJ.png

Stefano

考虑替代方案：

<properties>
    <javac.src.version>1.8</javac.src.version>
    <javac.target.version>1.8</javac.target.version>
</properties>

它应该与 maven.compiler.source/maven.compiler.target 相同，但上述解决方案对我有用，否则第二个得到父规范（我有一个 .pom 的 matrioska）

Amey

对于 NetBeans IDE，更改项目属性 - （泽西服务） - 类别 > 源 > 选择“源/二进制格式”为 1.8。

这不是问题的答案：“在 Maven 中指定 Java 版本”。你的回答，无论多么有效，都是在回答别的问题。

在 Maven 中指定 Java 版本 - 属性和编译器插件之间的差异

关注公众号

想领先一步获取最新的外包任务吗？

相似问题

平台

支持

联系我们