预览特性：试用草案，而不是半成品

预览特性在 class 文件里长什么样01

启用了预览特性的 class 文件，minor version 被写成 65535（0xFFFF），major version 仍是目标 JDK 的版本号（JDK 21 为 65）。JVM 看到 65535 就要求 --enable-preview。

javap -v Demo.class | head -5
# minor version: 65535
# major version: 65

• 预览特性与 JDK 版本绑定：JDK 21 的预览 class 不能在 JDK 22 的 JVM 上运行。
• --release 21 不仅设置 class 版本，还限制可用的 API 和语言特性；不写 --release 容易误用当前 JDK 的新 API。
• JShell 也需要 --enable-preview，例如 jshell --enable-preview。

JDK 21 的状态清单02

顺带一提：动态加载 Agent 的警告03

JEP 451 在 JDK 21 中让 JVM 在动态加载 Java Agent 时打印警告，为未来默认禁止做准备。它不是预览特性，而是「准备阶段」的弃用策略。

# 看到这类警告时：
WARNING: A {Java,JVM TI} agent has been loaded dynamically ...
WARNING: If a serviceability tool is in use, please run with -XX:+EnableDynamicAgentLoading ...

# 明确需要时：
java -XX:+EnableDynamicAgentLoading -jar app.jar

这类「准备弃用」的特性与 preview 不同：功能仍然默认可用，但未来版本可能改为默认拒绝。升级时应把它列入检查清单。

在构建工具中开启预览01

Maven

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-compiler-plugin</artifactId>
  <configuration>
    <release>21</release>
    <compilerArgs>
      <arg>--enable-preview</arg>
    </compilerArgs>
  </configuration>
</plugin>
<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-surefire-plugin</artifactId>
  <configuration>
    <argLine>--enable-preview</argLine>
  </configuration>
</plugin>

Gradle

tasks.withType(JavaCompile).configureEach {
    options.release.set(21)
    options.compilerArgs += "--enable-preview"
}

tasks.withType(Test).configureEach {
    jvmArgs += "--enable-preview"
}

• 编译参数和测试运行参数必须成对配置，否则测试会在类加载时失败。
• IDE 的「语言级别」和「JVM 参数」是两处独立设置，只改一处同样会失败。
• CI 中固定 JDK 发行版和版本号（例如 21.0.12），不要用浮动的 21 标签。

试用策略：隔离、标记、可回退02

1. 隔离：把预览特性封装在独立模块或适配层，业务代码依赖稳定接口。
2. 标记：在代码注释和构建脚本里明确标注预览版本与开关，方便升级时搜索。
3. 验证：CI 增加一个「预览开启」的 job，以及一个「关闭预览」的基线 job，确保主路径不依赖预览。
4. 回退：保留不依赖预览的实现分支；升级前先跑预览相关的编译与测试。

// 用运行时版本做显式检查，避免在不支持的 JDK 上误用
int feature = Runtime.version().feature();
if (feature < 21) {
    throw new IllegalStateException("需要 JDK 21+，当前 " + feature);
}

可运行示例：未命名类 + 实例 main03

// HelloPreview.java —— JDK 21 预览特性 JEP 445
void main() {
    System.out.println("Hello from " + Runtime.version());
    System.out.println("preview demo");
}

javac --enable-preview --release 21 HelloPreview.java
java --enable-preview HelloPreview

Hello from 21.0.12+7-LTS
preview demo

去掉 --enable-preview 运行会失败；把 class 文件拿到 JDK 22 上运行也会失败。这两点正是预览特性「与版本绑定」的直接体现。

先猜再看01

费曼自检：状态与升级02