VS Code配置多Java版本时新增JDK未显示在运行时配置菜单怎么办

问题根因 #

vscode-java扩展的JDK识别分两套逻辑，绝大多数人配置不生效都是踩了这两个逻辑的坑：

• 扩展自身运行要求最低JDK17版本，你删光系统Java环境变量后仍能识别到JDK17，是因为扩展自带了运行时依赖，这个内置JDK不会自动加入项目可选JDK列表。
• 项目可选JDK列表读取java.configuration.runtimes配置时，会做静默校验：路径格式错误、JDK路径层级不对、版本名不规范、JDK文件损坏/权限不足，都会直接跳过对应配置项，不会弹出任何报错提示。

分步解决流程 #

• 第一步：修正settings.json配置格式
  配置项必须严格按照规范填写，三个核心字段不能缺：
  • name字段必须固定写JavaSE-<版本号>格式，比如JDK14就写JavaSE-14，不能自定义别名，否则扩展无法匹配版本会直接忽略该条配置
  • path字段必须填JDK的根目录（也就是你能看到bin、lib、jre文件夹的那一层，不要写到bin目录里，也不要只写解压后的外层父文件夹）
  • Windows系统路径要么用双反斜杠转义，要么用正斜杠，不要用单反斜杠
    参考正确配置示例：

  {
    "java.configuration.runtimes": [
      {
        "name": "JavaSE-17",
        "path": "C:/dev/jdk/jdk-17.0.8",
        "default": true
      },
      {
        "name": "JavaSE-14",
        "path": "C:/dev/jdk/jdk-14.0.2"
      }
    ]
  }
  

  额外提醒：不要把JDK放在含中文、特殊字符、空格的路径下，扩展的路径解析逻辑对这类路径兼容性很差，会直接识别失败。

• 第二步：验证JDK14压缩包完整性
  打开你配置的JDK14路径下的bin文件夹，在文件夹地址栏输入cmd唤起命令行，执行.\java -version，如果能正常输出JDK14的版本信息就说明文件完整；如果执行报错，说明压缩包解压损坏，重新解压或者换一个可靠的压缩包即可。
• 第三步：清理语言服务缓存强制重载
  改完配置不要直接刷新窗口，按以下操作清缓存：
  1. 按Ctrl+Shift+P唤起命令面板，执行Java: Clean Java Language Server Workspace命令
  2. 弹出确认框时选择Restart and delete，等待Java语言服务自动重启完成
     重启后再打开「Configure Runtime for Projects」菜单，就能看到所有你配置过的JDK版本了。

效果验证 #

配置生效后不需要修改系统JAVA_HOME环境变量，就可以在运行时配置菜单里给不同项目单独指定JDK版本，打开Java文件时也可以直接在VS Code右下角切换当前项目的JDK版本。

内容的提问来源于stack exchange，提问作者RedCrafter LP