如何禁用 Java 21 中的编译器“预览功能”警告？

在 Java 21 中关闭编译器“预览功能”警告

背景

Java 21 引入了预览功能，允许开发人员抢先体验即将到来的 Java 版本中的新特性。然而，使用这些功能会导致编译器发出警告。本指南将介绍如何禁用这些警告，让你专注于代码开发。

解决方法

使用 Gradle

在 Gradle 构建文件中，添加 -Xlint:-preview 选项，以指示编译器忽略预览功能警告：

tasks
    .withType(JavaCompile)
    .configureEach {
        java {
            ...
            options.compilerArgs += [
                "--enable-preview",
                "-Xlint:-preview"
            ]
        }
    }

使用 Maven

在 Maven POM 文件中，添加 <argLine> 元素：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <configuration>
                <compilerArgs>
                    <arg>-Xlint:-preview</arg>
                </compilerArgs>
            </configuration>
        </plugin>
    </plugins>
</build>

使用 IDE

在 IntelliJ IDEA 或 Eclipse 等 IDE 中，可以在编译器设置中禁用预览功能警告。

使用注解

还可以使用 @SuppressWarnings("preview") 注解来禁止特定元素的警告：

@SuppressWarnings("preview")
public class MyClass {
    ...
}

结论

通过上述方法，你可以禁用 Java 21 编译器中的预览功能警告。这样，你就可以专注于代码开发，不必担心不必要的警告干扰。

常见问题解答

• 为什么我需要禁用预览功能警告？

禁用警告可以让你专注于代码开发，而不会受到预览功能不稳定性或即将发生的更改的干扰。

• 使用预览功能安全吗？

预览功能不稳定，可能发生更改或删除。在生产环境中使用前，建议进行全面测试。

• 如何启用预览功能？

在 Gradle 中使用 --enable-preview 选项或在 Maven 中使用 <preview> 元素即可启用预览功能。

• 是否可以有选择地禁用特定警告？

是的，可以使用 -Xlint:ignore 选项或 @SuppressWarnings("preview") 注解来禁止特定警告。

• 我应该什么时候启用预览功能？

仅在熟悉新功能并对其稳定性有信心时才启用预览功能。