必须手动勾选“enable preview features”并配置vm options为--enable-preview,否则编译或运行均失败;--release与--enable-preview可共存但顺序须正确,且编译与运行两端配置需严格一致。

IDEA 里编译阶段启用 --enable-preview 必须手动勾选
IntelliJ IDEA 不会自动识别你用了 record、virtual thread 或 pattern matching 就帮你开预览特性。哪怕 JDK 是 21,Language level 设成了 21,--enable-preview 依然是默认关闭的。
必须进 Settings → Build, Execution, Deployment → Compiler → Java Compiler,把 Target bytecode version 设为 21,然后勾选 Enable preview features。这个勾选等价于在 javac 命令后加 --enable-preview,缺了它,编译直接报错“not supported”。
运行配置里不加 --enable-preview 一定失败
编译通过 ≠ 能跑。IDEA 的运行配置(Run Configuration)是独立管理的,它不会复用编译器设置里的预览开关。
常见错误现象:UnsupportedOperationException: preview feature is not enabled 或 IncompatibleClassChangeError。
解决方法:编辑当前运行配置 → 在 VM options 输入框里手动填入 --enable-preview(注意不是 Program arguments)。
如果你有多个运行配置(比如 JUnit 测试、main 方法、Spring Boot 启动),每个都得单独加。
Maven/Gradle 项目在 IDEA 里仍需双端配置
即使 pom.xml 已配好 maven-compiler-plugin 的 <compilerargs>--enable-preview</compilerargs>,IDEA 也不会自动同步到自己的编译器或运行配置。
原因:IDEA 默认用内置构建流程(而非 Maven lifecycle),除非你显式开启 Delegate IDE build/run actions to Maven。
更稳妥的做法是:保持 Maven 配置有效的同时,在 IDEA 里也按前两个副标题操作——既勾编译器开关,又填运行时 VM options。
否则你会遇到“Maven 命令行能跑,IDEA 点绿色三角就崩”的情况。
--release 21 和 --enable-preview 可以共存,但顺序不能错
很多人以为 --release 会禁用预览特性,其实从 JDK 17 开始,--release 已支持预览特性(JDK 21 完全支持)。
正确写法是:javac --enable-preview --release 21 MyFile.java。
如果把 --release 21 放前面,--enable-preview 放后面,某些旧版 IDEA 插件可能解析失败;更关键的是,--enable-preview 必须出现在 --release 之后、源文件名之前。
IDEA 编译器界面不暴露这个顺序控制,所以依赖勾选“Enable preview features”后,它内部会自动拼对顺序——前提是 Target bytecode version 设对了版本号。
65535),只要编译和运行任意一端漏掉 --enable-preview,或者 JDK 版本不严格匹配(比如用 JDK 22 的 java 去运行 JDK 21 --enable-preview 编译的类),就会触发字节码校验失败。这不是配置遗漏,而是 JVM 的硬性安全机制。











