VSCode中java.home设置不生效的真正原因是其已被弃用，且Java扩展启动时仅首次读取环境变量；必须重启VSCode并配置java.configuration.runtimes才能正确绑定JDK。
VSCode 里 java.home 设置不生效的真正原因
不是路径写错了，而是 VSCode 启动时根本没读到你改的环境变量，或者压根没用它。Red Hat 的 Java 扩展（Language Support for Java）启动时优先扫描系统 JAVA_HOME 和常见安装路径，但只在**首次启动时加载一次**；后续修改环境变量、改了 PATH 或 JAVA_HOME，不重启 VSCode 就完全无效。
更关键的是：java.home 这个配置项在新版 Java 扩展中已被标记为「deprecated」——它只影响极少数旧功能（比如部分 Maven 集成），对 JDT LS（Java 语言服务器）和编译器调用基本不起作用。
- 改完系统环境变量后，必须关闭所有 VSCode 窗口（包括托盘进程），再重新打开
-
java.home只接受 JDK 根目录路径（如C:\Program Files\Java\jdk-17.0.2），不能指向bin子目录，否则javac会报错“command not found” - Windows 路径中的反斜杠要双写：
"java.home": "C:\\Program Files\\Java\\jdk-17.0.2"
java.configuration.runtimes 才是绑定 JDK 的正确开关
这是当前唯一可靠、多版本共存场景下必用的配置项。VSCode 的 Java 扩展用它来明确告诉 JDT LS：“这个项目/文件该用哪个 JDK 编译和运行”，不依赖系统变量，也不受 java.home 干扰。
打开设置（Ctrl+, ），搜索 java.configuration.runtimes，点击「在 settings.json 中编辑」，填入类似结构：
立即学习“Java免费学习笔记（深入）”；
[{"name":"JavaSE-17","path":"C:\\Program Files\\Java\\jdk-17.0.2"}]
注意几个硬性要求：
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
-
name必须严格匹配 JDK 的MANIFEST.MF中声明的执行环境，常见值只有：JavaSE-1.8、JavaSE-11、JavaSE-17、JavaSE-21；写jdk17或17都无效 -
path必须是 JDK 安装根目录（含bin、lib、jre等子目录），不是bin本身，也不是 JRE 路径 - Mac/Linux 用户若用 Homebrew 安装 OpenJDK，路径通常是
/opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk/Contents/Home，别漏掉最后的/Home
命令行 java -version 成功 ≠ VSCode 能识别 JDK
你在终端里敲 java -version 返回了版本号，不代表 VSCode 就能用这个 JDK。因为：
- VSCode 启动时可能继承的是系统默认 shell 的环境（比如 zsh 的
~/.zshrc），而你只在 bash 里配了JAVA_HOME - macOS 上
/usr/bin/java常是系统软链接，指向 JRE 而非 JDK，javac不存在，VSCode 检测失败 - Windows 用户如果只配置了
JAVA_HOME却没把%JAVA_HOME%\bin加进PATH，VSCode 内置终端也调不到javac
验证方法：在 VSCode 内置终端（Ctrl+`）里直接运行 javac -version。失败就说明扩展找不到可用的 JDK 编译器，此时 java.configuration.runtimes 是唯一补救手段。
裸跑单个 .java 文件时模块路径报错怎么办
点 Run 按钮提示 Cannot resolve module java.base，这不是环境变量问题，是 JDT LS 默认需要项目结构（src/ 目录或 module-info.java）才能挂载标准模块路径。
临时解决办法只有两个：
- 把
.java文件放到一个有src/子目录的文件夹里，并确保该文件夹被识别为 Java 项目（右下角状态栏出现 Java 图标） - 在
java.configuration.runtimes中指定的 JDK 必须是 9+ 版本（带模块系统），JDK 8 不支持java.base模块声明
没有项目结构、又不想建目录？那就别指望语义高亮和跳转——VSCode 对单文件 Java 的支持本质是“降级运行”，靠的是底层 javac + java 命令直调，不是真正的 IDE 级别支持。
