vscode不能自动识别jdk，必须手动配置java.home指向含bin/lib的jdk根目录（非jre或bin子目录），否则语言服务器无法启动、状态栏显示“no java runtime found”。
VSCode 能自动识别 JDK 17，但默认不读取 JAVA_HOME 或 PATH 中的 JRE 子目录——它只认完整的 JDK 安装根路径，且要求 bin/javac 和 lib/rt.jar（或 lib/modules）同时存在。
java.home 配置必须指向 JDK 根目录，不是 jre/ 子目录
很多用户把 java.home 设成 C:\Program Files\Java\jdk-17.0.8\jre 或 /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home/jre，结果 VSCode 启动失败，状态栏显示 “No Java runtime found”。这是因为 Java 扩展依赖编译器（javac）和语言服务器（jdt.ls），而 JRE 目录下没有 javac，也没有 lib/jdt-core.jar 等关键类库。
正确做法是：
-
java.home必须设为 JDK 安装根路径，例如C:\Program Files\Java\jdk-17.0.8或/opt/java/jdk-17.0.8 - 不要手动拼接
/jre；JDK 17+ 已取消独立 JRE，jre/目录在多数发行版中已不存在 - 若用
jlink自定义运行时，它生成的是纯运行时，不能用于 VSCode 开发环境
Java: Configure Java Runtime 不等于设置 java.home
命令面板里执行 Java: Configure Java Runtime 是管理「项目级」JRE 列表，用于指定不同项目的编译/运行目标版本（如 JavaSE-11、JavaSE-17），但它不会覆盖全局 java.home 设置。如果你只在这里选了 JDK 17，但 java.home 仍为空或指向错误路径，语言服务器依然无法启动。
常见误操作：
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 只点
Add JDK，却没确认是否被设为default - 添加后未重启 VSCode 窗口（仅重载窗口不够，需完全关闭再打开）
- 在多工作区中，该配置只影响当前文件夹，对其他打开的 Java 项目无效
自动探测失败时，优先检查 JDK 发行版兼容性
VSCode Java 扩展能自动扫描常见路径，但并非所有 JDK 都被平等支持。Adoptium（Temurin）、Oracle JDK、Amazon Corretto 基本都能识别；而某些精简版（如 Liberica Lite）或自编译 OpenJDK 可能缺失 release 文件或签名元数据，导致探测跳过。
验证方式：
- 打开任意
.java文件，看右下角状态栏是否出现 JDK 版本号（如17.0.8） - 若无，按
Ctrl+Shift+P→ 输入Java: Show Java Home，它会列出所有探测到的候选路径 - 若列表为空，说明扩展根本没扫描到你的 JDK —— 此时手动填
java.home是唯一可靠方案
java.configuration.runtimes 是给 Maven/Gradle 项目用的，别和 java.home 混用
java.configuration.runtimes 是为多版本构建设计的：比如项目 pom.xml 声明 java.version=11，但你本地只有 JDK 17，这时可通过该配置告诉 Maven 插件“用这个 JDK 来模拟 Java 11 编译行为”。它不影响语言服务器启动，也不替代 java.home。
典型错误配置：
- 删掉
java.home，只留java.configuration.runtimes→ 语言服务器报错退出 - 在
runtimes中写"path": "/path/to/jdk-17/jre"→ Maven 插件报Cannot resolve javac - 路径中混用反斜杠
\和正斜杠/（Windows 上尤其容易出问题）→ JSON 解析失败，整个 Java 设置失效
最易被忽略的一点：VSCode Java 扩展启动时会 fork 一个独立的 JVM 进程运行 jdt.ls，它**完全不继承系统终端的环境变量**。所以即使你在 shell 里 echo $JAVA_HOME 正确，VSCode 也看不到——必须显式通过 java.home 或 settings.json 注入。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
