预览版特性是语言或平台正式发布前开放试用的未稳定功能,api、语法及行为可能变更或删除;它们已通过内部验证但需社区反馈定稿,如java record、c#主构造函数等。

什么是预览版特性(Preview Features)
预览版特性是语言或平台在正式发布前开放试用的功能,它们尚未稳定,API、语法甚至行为都可能在后续版本中变更或删除。preview 不代表“半成品”,而是“已通过内部验证、但需社区反馈后再定稿”的功能。Java 的 record、pattern matching,C# 的 primary constructors,TypeScript 的 const type parameters 都曾以 preview 形式出现。
IDE 中开启预览特性支持的关键操作
不是所有 IDE 默认启用预览特性,即使你装了新 JDK 或新 TS 版本。核心在于:让 IDE 明确知道“你要用未稳定语法”,否则编辑器会报红、补全失效、甚至编译失败。
- IntelliJ / IDEA:
Settings → Languages & Frameworks → Java → Project → Project SDK选对 JDK 后,再进Language level→ 勾选Use preview features(Java 14+ 才显示) - VS Code + Java Extension:
settings.json加"java.configuration.updateBuildConfiguration": "interactive",并在pom.xml或build.gradle中显式启用,例如 Maven 插件加<arg>--enable-preview</arg> - VS Code + TypeScript:
tsconfig.json中设"compilerOptions": { "experimentalDecorators": true, "useDefineForClassFields": true }——注意:这些虽不叫 “preview” 字样,但属于 TS 官方标注为experimental的特性,需手动开
为什么开了还不生效?常见断点排查
开了开关 ≠ 立刻能写能跑。预览特性常卡在工具链中间层,尤其容易被构建系统或 LSP 服务忽略。
-
javac编译时漏掉--enable-preview参数 → 即使 IDE 显示正常,命令行mvn compile仍报错error: illegal start of expression - Gradle 构建中未配置 JVM args:
compileJava { options.fork = true; options.jvmArgs += ['--enable-preview'] } - TypeScript 的
tsc --noEmit检查阶段不识别实验性语法 → 必须确保tsconfig.json中"checkJs": true(如用 JS)或"allowJs": true配合"checkJs"开启类型检查 - VS Code 的 TS Server 缓存未刷新 → 改完
tsconfig.json后按Ctrl+Shift+P → TypeScript: Restart TS server
预览特性上线后的真实代价
它不只是“多一个语法糖”。启用预览特性意味着你主动承担三类隐性成本:
- CI/CD 流水线必须统一 JDK/TS 版本 + 显式传参,否则本地能过、CI 报错
- 团队协作时,新人拉代码后 IDE 不报错但运行失败,因为没注意到 README 里那行小字:“需 JDK 21+ 并启用 preview”
- 某些预览特性在不同 patch 版本间有 breaking change,比如 Java 21 的
virtual threads在 early-access build 和 GA 版的Thread.ofVirtual()签名就微调过
最常被忽略的一点:预览特性通常不进 Javadoc、不进官方语言规范草案初稿,遇到歧义只能翻 release note 或 OpenJDK 邮件列表——文档支援几乎是零。










