java.home控制运行调试，java.jdt.ls.java.home控制语言服务；二者职责分离，必须分别正确配置JDK根目录路径，且修改后需重启Java Language Server方可生效。
java.home 和 java.jdt.ls.java.home 的区别必须分清
很多人以为设一个 java.home 就万事大吉，结果调试时用的 JDK 和语言服务器（JDT.LS）用的不是同一个，导致代码提示正常但运行报错、断点不生效、甚至 Ctrl+Click 跳不到源码。根本原因是：VS Code Java 扩展里有两个独立的 JDK 配置项，职责完全不同。
-
java.home：只影响「运行和调试」——比如按F5启动、右键Run Java、Maven 构建命令调用的 JDK -
java.jdt.ls.java.home：只影响「语言服务」——比如语法高亮、自动补全、错误检查、跳转定义、重命名等所有编辑时功能
两者可以指向不同版本，但绝大多数项目没必要这么干。更稳妥的做法是让它们一致，避免行为割裂。
settings.json 里怎么写才不会出错
在项目根目录下创建或编辑 .vscode/settings.json，必须写成完整路径，且指向 JDK 根目录（不是 bin/，也不是 jre/）。Windows 上路径里的反斜杠要转义，或者直接用正斜杠；macOS/Linux 注意权限和符号链接问题。
- ✅ 正确示例（JDK 21）：
{ "java.home": "/Library/Java/JavaVirtualMachines/openjdk-21.0.2.jdk/Contents/Home", "java.jdt.ls.java.home": "/Library/Java/JavaVirtualMachines/openjdk-21.0.2.jdk/Contents/Home" } - ❌ 常见错误：
— 写成"java.home": "/path/to/jdk/bin"（少一层Home）
— 写成"java.home": "~/jdk-21"（~在 VS Code 里不展开）
— Windows 下写成C:\Program Files\Java\jdk-21（没转义空格和反斜杠，会解析失败）
命令面板配置 vs 手动改 settings.json，哪个优先级更高
通过 Ctrl+Shift+P → Java: Configure Java Runtime 操作，本质就是自动生成或覆盖 .vscode/settings.json 里的 java.home 和 java.jdt.ls.java.home。它的优先级高于全局设置（用户级 settings.json），但低于项目级配置（即当前工作区下的 .vscode/settings.json）。
- 如果你手动编辑了
.vscode/settings.json，再用命令面板切换 JDK，它会把你手写的覆盖掉 - 如果你没建
.vscode/settings.json，命令面板的配置会生成这个文件，并写入两个字段 - 多模块项目里，建议每个子模块单独配
.vscode/settings.json，而不是依赖根目录配置——因为不同模块可能要求不同 JDK 版本编译（比如release=17但运行在 JDK 21 上）
为什么有时候改了 settings.json 还不生效
最常被忽略的一点：Java Language Server 启动后不会自动 reload JDK 配置。改完 settings.json 必须重启语言服务器，否则还是用旧的 JDK。
- 快捷方式：按
Ctrl+Shift+P→ 输入Java: Restart Language Server，回车 - 验证是否生效：打开任意
.java文件，按Ctrl+Shift+P→Java: Show Java Home，看弹出路径是否和你设的一致 - 如果仍显示错误路径，检查终端里
echo $JAVA_HOME（macOS/Linux）或echo %JAVA_HOME%（Windows）——GUI 启动的 VS Code 可能压根没继承 shell 环境变量，此时仅靠settings.json是唯一可靠方式
真正麻烦的从来不是“怎么配”，而是配完之后没人告诉你语言服务器还卡在旧进程里。改完配置不重启 LS，等于白改。
