VS Code Java 扩展插件 JDK 版本报错解决方案

VS Code Java 扩展插件 Language Support for Java(TM) by Red Hat 在运行时可能报错提示需要 JDK 21 或更高版本。

错误信息指出：运行 Java 扩展需要 Java 21 或更高版本。请下载并安装最新的 JDK。您仍然可以通过配置 'java.configuration.runtimes' 使用较旧的 JDK 编译项目。

如果项目依赖旧版本 JDK 但需使用该插件，有两种解决方案。

方案一：升级 JDK 版本

根据提示下载新版 JDK。例如原使用 JDK 17，插件要求 JDK 21，则下载对应的 JDK 21 版本。

打开 VS Code 设置搜索 java.configuration.runtimes，点击 "在 setting.json 中编辑"。

修改 java.configuration.runtimes 下的内容。第一处为项目运行所需，填写名字和路径，并添加 "default": true；第二处为插件运行所需，填写名字和路径。保存文件即可。

{
  "java.configuration.runtimes": [
    {
      "name": "JavaSE-17",
      "path": "/usr/lib/jvm/java-17-openjdk-amd64",
      "default": true
    },
    {
      "name": "JavaSE-21",
      "path": "/usr/lib/jvm/java-21-openjdk-amd64"
    }
  ]
}

方案二：降级插件版本

更换到 Language Support for Java(TM) by Red Hat 插件的历史版本。右键插件，选择安装特定版本，找到适合当前 JDK 的插件版本进行切换。此方法仅在不方便升级 JDK 时考虑。