本文详解如何在 vscode 中正确启用 jdk 20 的 --enable-preview 特性，涵盖 settings.json 的运行时声明、launch.json 的 jvm 参数配置及常见误区，确保虚拟线程等预览功能可正常编译与运行。
本文详解如何在 vscode 中正确启用 jdk 20 的 --enable-preview 特性，涵盖 settings.json 的运行时声明、launch.json 的 jvm 参数配置及常见误区，确保虚拟线程等预览功能可正常编译与运行。
在 JDK 20 中，虚拟线程（Virtual Threads）、结构化并发（Structured Concurrency）等关键新特性默认处于预览阶段（Preview Features），必须显式启用 --enable-preview 才能使用。仅在 settings.json 中为 JDK 运行时添加 "vmargs": ["--enable-preview"] 是无效的——该字段在 Java 扩展中不被识别用于启动 JVM，且 java.configuration.runtimes 的 vmargs 实际上是被忽略的（截至 2026 年最新版 Extension Pack for Java v1.52+）。
✅ 正确做法是：将 --enable-preview 作为 JVM 启动参数（VM arguments），明确写入 launch.json 的 vmArgs 字段中（注意拼写为 vmArgs，非 vmargs 或 args）：
{
"version": "0.2.0",
"configurations": [
{
"type": "java",
"name": "Current File (with preview)",
"request": "launch",
"mainClass": "${file}",
"vmArgs": "--enable-preview"
},
{
"type": "java",
"name": "App (with preview)",
"request": "launch",
"mainClass": "App",
"projectName": "VirtualThread_c7b22327",
"vmArgs": "--enable-preview"
}
]
}
⚠️ 关键说明：
- vmArgs（字符串或字符串数组）：传递给 JVM 的参数，如 --enable-preview、-Xmx2g、--add-opens 等；
- args：传递给Java 应用程序主方法 main(String[]) 的命令行参数，对 JVM 本身无影响；
- 若使用数组形式，推荐写为 "vmArgs": ["--enable-preview"]；单字符串 "vmArgs": "--enable-preview" 同样有效且更简洁。
此外，请确保以下基础配置已就绪：
-
JDK 20 已正确注册为项目运行时（推荐方式，优于硬编码 java.home）：
- 按 Cmd+Shift+P（macOS）或 Ctrl+Shift+P（Windows/Linux）打开命令面板；
- 输入并选择 Java: Configure Java Runtime；
- 在 JDKs 标签页点击 + Add JDK，选择 JDK 20 的根目录（例如 /Users/rahulraj/Library/Java/JavaVirtualMachines/openjdk-20.0.1/Contents/Home），切勿选 bin 或 jre 子目录；
- 完成后，状态栏右下角应显示 20，表示当前工作区已识别 JDK 20。
-
项目级 settings.json（工作区级）建议补充编译器合规性（可选但推荐）：
在项目根目录下的 .vscode/settings.json 中添加：{ "java.configuration.updateBuildConfiguration": "interactive", "java.compile.nullAnalysis.mode": "automatic", "java.configuration.runtimes": [ { "name": "JavaSE-20", "path": "/Users/rahulraj/Library/Java/JavaVirtualMachines/openjdk-20.0.1/Contents/Home" } ] }✅ 注意：此处 runtimes 仅用于声明可用 JDK 列表和名称映射，不承担传参职责；vmArgs 必须由 launch.json 承载。
-
验证是否生效：
编写测试代码（如 Test.java）：public class Test { public static void main(String[] args) { Thread thread = Thread.ofVirtual().unstarted(() -> System.out.println("Hello from virtual thread!")); thread.start(); } }使用上述带 vmArgs 的 launch 配置运行，不再抛出 UnsupportedOperationException: Preview Features not enabled 即表示成功。
? 总结：
JDK 预览特性的启用是运行时行为，而非编译时或环境变量配置。VSCode Java 扩展严格区分 vmArgs（JVM 层）与 args（应用层）。务必通过 launch.json 的 vmArgs 字段注入 --enable-preview，并配合 Java: Configure Java Runtime 完成 JDK 注册，即可在 VSCode 中安全、稳定地体验 JDK 20 虚拟线程等前沿特性。
