什么是JDK的预览特性 (Enable-Preview)_如何在命令行开启新语法

秋浩君_4016

秋浩君_4016

2026-02-18

403人浏览

原创

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

什么是jdk的预览特性 (enable-preview)_如何在命令行开启新语法

预览特性到底能不能用?

能用,但不建议上生产。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 走下去,直到它转正。提前想清楚值不值得押注。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
eclipse教程
eclipse教程

php中文网为大家带来eclipse教程合集,eclipse是一个开放源代码的、基于Java的可扩展开发平台。就其本身而言,它只是一个框架和一组服务,用于通过插件组件构建开发环境。php中文网还为大家带来eclipse的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.14

670

5

eclipse怎么设置中文
eclipse怎么设置中文

eclipse设置中文的方法:除了设置界面为中文外,你还可以为Eclipse添加中文插件,以便更好地支持中文编程。例如,你可以安装EBNF插件来支持中文变量名,或安装Chinese Helper来提供中文帮助文档。本专题为大家提供eclipse设置中文相关的各种文章、以及下载和课程。

2023.07.24

5606

6

c语言编程软件有哪些
c语言编程软件有哪些

c语言编程软件有GCC、Clang、Microsoft Visual Studio、Eclipse、NetBeans、Dev-C++、Code::Blocks、KDevelop、Sublime Text和Atom。更多关于c语言编程软件的问题详情请看本专题的文章。php中文网欢迎大家前来学习。

2023.11.02

8659

18

Eclipse版本号有哪些区别
Eclipse版本号有哪些区别

区别:1、Eclipse 3.x系列:Eclipse的早期版本,包括3.0、3.1、3.2等;2、Eclipse 4.x系列:Eclipse的最新版本,包括4.0、4.1、4.2等;3、Eclipse IDE for Java Developers等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

2804

5

eclipse和idea有什么区别
eclipse和idea有什么区别

eclipse和idea的区别:1、平台支持;2、内存占用;3、插件系统;4、智能代码提示;5、界面设计;6、调试功能;7、学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

642

5

eclipse设置中文全教程
eclipse设置中文全教程

本专题整合了eclipse设置中文相关教程,阅读专题下面的文章了解更多详细操作。

2025.10.10

3606

11

eclipse字体放大教程
eclipse字体放大教程

本专题整合了eclipse字体放大教程,阅读专题下面的文章了解更多详细内容。

2025.10.10

3625

12

eclipse左边栏不见了解决方法
eclipse左边栏不见了解决方法

本专题整合了eclipse左边栏相关教程,阅读专题下面的文章了解更多详细内容。

2025.10.15

508

3

eclipse字体相关教程
eclipse字体相关教程

本专题整合了eclipse字体设置相关教程,阅读专题下面的文章了解更多详细内容。

2025.11.26

874

12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.9万人学习