本文详解如何通过 launch.json 正确配置 jvm 参数（尤其是 --enable-preview），解决在 vscode 中运行 jdk 20+ 预览功能（如 thread.ofvirtual()）时因参数位置错误导致的 unsupportedoperationexception 报错问题。
本文详解如何通过 launch.json 正确配置 jvm 参数（尤其是 --enable-preview），解决在 vscode 中运行 jdk 20+ 预览功能（如 thread.ofvirtual()）时因参数位置错误导致的 unsupportedoperationexception 报错问题。
在 JDK 20 及更高版本中，虚拟线程（Virtual Threads）等新特性默认以预览模式（Preview Feature） 提供，必须显式启用 --enable-preview JVM 启动参数才能使用。许多开发者误将该参数写入 args 字段（即程序参数），但 args 仅传递给 main(String[] args) 方法，不会影响 JVM 本身；真正控制 JVM 行为的参数必须通过 vmArgs 字段传入。
✅ 正确做法：在 .vscode/launch.json 的对应调试配置中，使用 vmArgs（注意是复数形式）指定 JVM 参数：
{
"version": "0.2.0",
"configurations": [
{
"type": "java",
"name": "Debug Virtual Thread",
"request": "launch",
"mainClass": "App",
"vmArgs": "--enable-preview", // ✅ 关键：此处启用预览特性
"projectName": "VirtualThread_c7b22327"
}
]
}
⚠️ 注意事项：
- vmArgs 是字符串类型（支持空格分隔多个参数），不是数组。若需多个参数，用空格连接，例如："--enable-preview --XX:+UnlockExperimentalVMOptions"。
- settings.json 中的 "vmargs"（如 java.jdt.ls.vmargs）仅影响 Java 语言服务器（JDT LS）自身启动，与用户代码运行无关，不能用于启用应用级预览特性。
- java.configuration.runtimes 中的 "vmargs" 字段（如你在问题中尝试的）不被 VSCode Java 扩展识别或应用——该字段在当前（2026年）主流版本中属于无效配置项，会被忽略。
- 确保 java.home 或 java.jdt.ls.java.home 已正确指向 JDK 20+ 安装路径（如 macOS 示例：/Users/rahulraj/Library/Java/JavaVirtualMachines/openjdk-20.0.1/Contents/Home），否则即使参数正确，也会因运行时版本不匹配而失败。
? 验证是否生效：在 main 方法开头添加以下代码，运行后应输出 true：
public class App {
public static void main(String[] args) {
System.out.println("Preview enabled: " +
java.lang.Runtime.version().feature() >= 20); // JDK 20+
System.out.println("Is virtual thread supported: " +
java.lang.Thread.class.getDeclaredMethods()
.length > 0); // 简单探测（实际建议 try-catch 调用 ofVirtual）
// ✅ 正确调用虚拟线程（需 --enable-preview）
Thread vt = Thread.ofVirtual().unstarted(() ->
System.out.println("Running on virtual thread: " + Thread.currentThread()));
vt.start();
}
}
? 总结：启用 JDK 预览特性是“JVM 层”行为，必须通过调试器的 vmArgs 透传至 JVM 进程；settings.json 仅负责开发环境元信息（如编译目标、语言服务器路径），不参与运行时参数注入。掌握这一关键区分，即可彻底规避 Preview Features not enabled 类错误，从容驾驭 JDK 20+ 的前沿能力。
