能用但不建议上生产,因预览特性语法/api未定稿、需编译运行同步启用--enable-preview、版本严格匹配、ide和构建工具需双端配置、字节码含特殊标记导致混用报错。

预览特性到底能不能用?
能用,但不建议上生产。JDK 的 --enable-preview 是官方明确标注“可能变更、可能删除”的功能开关,不是 beta 版本,而是“语法/API 尚未最终定稿”的信号。Java 14 引入 record 时就走的这条路,直到 Java 16 才转正;switch 表达式也是从 Java 12 预览、13 再预览、14 转正。开启它,等于主动接受编译期和运行时的双重不稳定。
命令行怎么开?必须配齐三步
只加 --enable-preview 不够,编译和运行要同步开启,且 JDK 版本必须匹配预览特性所属版本。比如 Java 21 的 virtual threads(Thread.ofVirtual())必须用 JDK 21+,且不能用 JDK 22 的 javac 去编译 Java 21 的预览代码。
-
javac --enable-preview --release 21 Main.java:编译时启用,--release锁定目标版本(推荐,避免意外引用高版本 API) -
java --enable-preview Main:运行时也必须加,否则报错UnsupportedOperationException: preview feature is not enabled - 如果用
-source/-target,必须和 JDK 主版本一致,例如 JDK 21 下不能写-source 20启用 Java 21 预览特性
IDE 里点几下就完事?别信
IntelliJ 或 VS Code 的图形化开关(如 “Enable preview features” 复选框)只改了编译器参数,不自动同步 JVM 运行参数。你 IDE 里编译通过、绿色运行按钮一按就报错,大概率是 java 命令没带 --enable-preview。
- Maven 用户得在
pom.xml里同时配置maven-compiler-plugin的<compilerargs></compilerargs>和maven-surefire-plugin的<argline></argline> - Gradle 用户需分别设置
compileJava.options.compilerArgs和test.jvmArgs - 哪怕只是临时跑个
java -cp . Main,漏掉--enable-preview就直接抛IncompatibleClassChangeError
为什么编译通过但运行时报错 UnsupportedClassVersionError?
因为预览特性生成的字节码版本号和普通代码不同。JDK 强制要求:启用预览特性的类,其 class 文件主版本号后面会多一个标记位。一旦你用 --enable-preview 编译,就必须用同版本 JDK + --enable-preview 运行 —— 混用 JDK 21 编译、JDK 22 运行,或反过来,都会触发这个错误。
- 检查方式:
javap -v Main.class | grep "major version",再对比java -version - 常见陷阱:CI 环境里
JAVA_HOME和PATH指向不同 JDK;Docker 镜像用了eclipse-temurin:21-jre却没传--enable-preview给java - 没有兼容模式,没有降级路径 —— 预览特性就是“全有或全无”
最麻烦的不是怎么开,而是关不掉:只要项目里有一个类用了预览语法,整个模块就得持续带着 --enable-preview 走下去,直到它转正。提前想清楚值不值得押注。










