OpenJDK在VS Code里怎么配置java.configuration.runtimes-java教程-PHP中文网

java.configuration.runtimes 是vs code中用于指定项目编译、运行和调试所用jdk列表的配置项，决定javac版本、字节码目标及语法支持；它与仅影响语言服务器启动的java.home完全独立，必须在工作区.vscode/settings.json中配置，且name须为标准标识如javase-17，path须指向jdk根目录。

openjdk在vs code里怎么配置java.configuration.runtimes

java.configuration.runtimes 是什么，为什么不能只配 `java.home`

java.home 只告诉 VS Code “语言服务器（JDT.LS）自己该用哪个 JDK 启动”，它影响的是插件本身的运行环境；而 java.configuration.runtimes 是给项目编译、运行、调试用的 JDK 列表，决定 javac 版本、字节码目标版本、@Override 语义是否合法等。两者完全独立，缺一不可。

常见错误现象：你改了 java.home，但新建一个 record 类仍报错“Records are not supported at this language level”——这就是因为 java.configuration.runtimes 没配或配错了 JDK 版本。

必须在工作区根目录的 .vscode/settings.json 中配置，全局设置（User Settings）不生效
路径必须是 JDK 安装根目录（含 bin/javac 和 lib/rt.jar 或 lib/modules），不是 JRE 路径，也不是 bin 子目录
Windows 下路径分隔符要用双反斜杠 \ 或正斜杠 /，单反斜杠会解析失败

怎么写一个可用的 `java.configuration.runtimes` 配置

最简有效写法（以 JDK 17 为例）：

{
  "java.configuration.runtimes": [
    {
      "name": "JavaSE-17",
      "path": "/opt/java/jdk-17.0.2"
    }
  ]
}

关键点：

OpenJDK 24

下载

name 必须是标准标识符，如 JavaSE-8、JavaSE-11、JavaSE-17、JavaSE-21，不能写成 jdk17 或 17，否则 Maven 插件和编译器无法识别
path 要指向 JDK 安装根目录，例如 macOS 上用 SDKMAN 安装的路径通常是 ~/.sdkman/candidates/java/current，Linux apt 安装的可能是 /usr/lib/jvm/java-17-openjdk-amd64
如果只配一个 JDK，无需加 "default": true；多个 JDK 时，只有标了 "default": true 的才会被自动选为当前项目默认运行时

多 JDK 共存时怎么切换项目使用的版本

VS Code 不支持像 IDEA 那样右键“Project SDK”一键切换。切换依赖于 java.configuration.runtimes 中的 name 和 Java 文件顶部的 /** @compile-with JavaSE-11 */ 注释（不推荐），真正可靠的方式是：

每个项目根目录单独配 .vscode/settings.json，只保留该项目需要的 JDK 条目
不同项目用不同 name（如一个写 JavaSE-17，另一个写 JavaSE-21），VS Code 会根据 module-info.java 或 pom.xml 中的 <java.version></java.version> 自动匹配最接近的 runtime
手动触发匹配：按 Ctrl+Shift+P → 输入 Java: Configure Classpath → 在弹出面板中选择对应 name

注意：Maven 项目中，pom.xml 的 <maven.compiler.source></maven.compiler.source> 和 <maven.compiler.target></maven.compiler.target> 必须与 java.configuration.runtimes 中某条目的 name 对齐，否则编译输出的 class 文件可能被拒绝加载。

常见报错和排查线索

典型错误信息：Cannot resolve the classpath for project 'xxx'、No Java runtime present, requesting install、Source level does not match runtime。

检查 path 是否真实存在且可读：ls -l /your/path/bin/javac（Linux/macOS）或 dir C:path ojdkinjavac.exe（Windows）
确认该 JDK 支持你写的语法：比如用了 sealed 类却配了 JavaSE-11，就得换成 JavaSE-17 或更高
删除 .vscode 下的 java 缓存目录（路径类似 .vscode/java/workspace），然后执行 Java: Clean and Rebuild Workspace
打开命令面板 → Java: Open Java Language Server Log，搜索 runtime 或 resolve 关键字，看是否加载失败