JDK 26 预览特性启用参数怎么管理

JDK 26 的预览特性不是“装了 JDK 就自动可用”。真正需要管理的是两组参数：javac 编译时打开 --enable-preview，并把语言级别锁到 --release 26；程序启动时再给 java 传一次 --enable-preview。少一组，报错位置就会不同；混用 JDK 25 和 JDK 26，则会把问题变成版本错配。

官方核对入口：https://docs.oracle.com/en/java/javase/26/docs/specs/index.html

先把两个开关分清：编译端和运行端不是一回事

Oracle 的 JDK 26 工具文档明确说明，javac --enable-preview 用来启用预览语言特性，而且必须与 -source 或 --release 一起使用。java --enable-preview 则允许运行依赖该版本预览特性的 class 文件。它们作用在两个阶段，不能只在编译命令里写一次。

JDK 26 当前规范把“Primitive Types in Patterns, instanceof, and switch”列为预览语言特性。预览功能的价值是让开发者提前试用并反馈，但语法和语义仍可能变化，所以参数管理的第一原则是把它隔离在明确的开发、实验或兼容性构建中。

本地编译和运行，先固定同一套 JDK 26 参数

下面用一个最小示例说明参数位置。示例使用 JDK 26 才能识别的预览语法；代码中的注释只解释关键边界，不把预览代码伪装成稳定语法。

public class PreviewDemo {
    public static void main(String[] args) {
        Object value = Integer.valueOf(42);
        // JDK 26 预览能力允许在模式匹配中直接表达 primitive 类型。
        if (value instanceof int number) {
            System.out.println("number=" + number);
        }
    }
}

# 编译端：--enable-preview 必须和 --release 26 同时出现
rm -rf out
mkdir -p out
javac --enable-preview --release 26 -d out PreviewDemo.java

# 运行端：启动 JVM 时再次打开同一代预览能力
java --enable-preview -cp out PreviewDemo

这里不要把 --release 26 换成任意旧版本。--enable-preview 只对当前编译代际有意义；编译器、class 文件和运行时应当来自同一代 JDK。若只想用单文件模式，也可以在 JDK 26 上执行 java --enable-preview PreviewDemo.java，但 CI 仍建议显式拆开编译和运行，便于定位问题。

把编译参数、JVM 参数和测试参数分层管理

项目里最容易出错的地方是把“编译器参数”和“运行时参数”塞进同一个字段。更稳妥的做法是只集中维护版本和预览开关，任务各自接收适合自己的参数。

# CI 只在一个地方锁版本，避免 compile/test/run 各写一套数字
JDK_VERSION=26
PREVIEW_FLAG=--enable-preview

# 编译任务使用语言级别；测试和运行任务使用 JVM 开关
javac "$PREVIEW_FLAG" --release "$JDK_VERSION" -d out src/PreviewDemo.java
java "$PREVIEW_FLAG" -cp out PreviewDemo
# Maven Surefire、Gradle test 等测试进程也要传入同一个 PREVIEW_FLAG

如果使用 Maven，可把 --enable-preview 放入编译插件的 compiler arguments，同时把它放入测试插件的 argLine；Gradle 则分别配置 JavaCompile.options.compilerArgs 和测试任务的 jvmArgs。不要只配置 IDE 的运行配置，因为命令行构建和 CI 不会自动继承它。

从预览试验退出时，给生产链路设一道门

预览特性适合验证语法收益、跑兼容性测试和收集团队反馈，不适合悄悄成为所有生产构建的默认参数。可以把预览代码放在单独模块，或让 CI 用显式 profile 开启；稳定分支默认不携带 --enable-preview，只有实验任务和专门的回归任务启用。

排查时按这个顺序看：先执行 java -version 和 javac -version，再检查编译命令是否同时含有两个编译参数，最后检查测试/运行进程的 JVM 参数。若出现 release version 26 not supported，先换编译器；若编译成功却在启动时报预览未开启，补的是运行参数，不是重新改源码。

常见问题

只写 --enable-preview，为什么 javac 仍然报错？

因为编译器还需要知道对应的语言版本。JDK 26 项目应使用 --release 26 或 -source 26，不能把预览开关单独使用。

编译成功后，为什么 java 启动仍提示预览特性未启用？

编译开关不会写入一个让所有 JVM 自动继承的全局状态。启动命令仍要显式加入 java --enable-preview，测试进程也一样。

预览 class 文件能否交给更旧的 JDK 运行？

不要这样管理。预览特性和具体 JDK 版本绑定，编译器与运行时应保持同一代；旧 JDK 应走不含预览语法的稳定构建。

JDK 26 的参数管理重点不是记住一个神奇开关，而是把版本、编译阶段和运行阶段拆开记录。这样预览特性发生变化时，团队能快速关闭实验链路，也能准确判断是源码能力、编译参数还是 JVM 参数出了问题。