VSCode装完Java插件却跑不了代码，根本原因是JDK未被真正识别：java.home已弃用，必须配置java.configuration.runtimes数组，path指向JDK根目录（含bin/lib），name严格匹配JavaSE-17等标准值，并重启VSCode生效。
VSCode 装完 Java 插件却跑不了代码？不是插件没装对，而是 JDK 没被真正识别——java.home 和 java.configuration.runtimes 这两个配置项没设对，或者系统环境变量没生效。
Java -version 能用，但 VSCode 仍报“Command 'Java: Create Java Project' not found”
这是最典型的假成功：命令行里 java -version 和 javac -version 都返回正常，但 VSCode 的 Java 功能全灰掉。根本原因不是 JDK 没装，而是 VSCode 启动时没读到有效 JDK 路径。
- Windows 用户常漏掉一步：只设了
JAVA_HOME，但没把%JAVA_HOME%\bin加进Path—— VSCode 启动时依赖Path找javac，光有JAVA_HOME不够 - macOS/Linux 用户容易踩坑：
/usr/bin/java是系统软链接，通常指向 JRE 而非 JDK，javac不存在，VSCode 直接放弃扫描 - VSCode 只在启动时读环境变量：改完环境变量后，必须关掉所有 VSCode 窗口（包括托盘进程），再重新打开，热加载不生效
settings.json 里该配 java.home 还是 java.configuration.runtimes？
优先用 java.configuration.runtimes，它比 java.home 更可靠，尤其多 JDK 版本共存时。
-
java.home是旧配置项，仅影响部分老插件行为；VSCode 当前主力 Java 扩展（Red Hat 的 Language Support for Java）已弃用它 -
java.configuration.runtimes是唯一能真正绑定 JDK 版本的配置，必须写成数组格式，且path必须指向 JDK 根目录（含bin/、lib/子目录），不能指向bin本身 -
name字段不是随便起的，要匹配 JDK 自带的MANIFEST.MF中的Bundle-RequiredExecutionEnvironment值，常见合法值："JavaSE-17"、"JavaSE-21"、"JavaSE-11" - 示例（macOS）：
[{"name":"JavaSE-17","path":"/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home"}]
Homebrew 安装的 OpenJDK 总被 VSCode 忽略
Homebrew 默认把 JDK 装在 /opt/homebrew/opt/openjdk（Apple Silicon）或 /usr/local/opt/openjdk（Intel），但 VSCode 不主动扫描这些路径。
立即学习“Java免费学习笔记（深入）”；
- 别用
brew link openjdk创建软链接到/usr/local/bin—— 这只会让java可用，javac仍找不到，VSCode 会跳过该路径 - 正确做法：在
java.configuration.runtimes中显式填入 Homebrew JDK 的真实根路径，比如："/opt/homebrew/opt/openjdk/libexec/openjdk.jdk/Contents/Home" - 验证路径是否有效：进终端，执行
ls /opt/homebrew/opt/openjdk/libexec/openjdk.jdk/Contents/Home/bin/javac，能列出文件才算对 - Windows 上用 Scoop 或 Chocolatey 安装的 JDK 同理，必须填实际安装路径，不能依赖自动发现
运行单个 .java 文件时报 “Cannot resolve module java.base”
这不是环境变量问题，是 JDT LS（VSCode 底层 Java 语言服务器）没加载模块路径——它默认只在项目结构下工作，裸文件不触发完整初始化。
- 别点左上角“运行和调试”按钮，那是为项目调试设计的；直接右键编辑器空白处 → “Run Java”，它会绕过 JDT LS 模块检查，用你配置的
java.configuration.runtimes直接调java执行 - 如果想调试，必须让文件处于合法 Java 项目结构中：目录下要有
src/子目录，或存在module-info.java，否则断点不会命中 - 不要在文件顶部加注释试图“骗过”JDT LS，比如
// @module java.base—— 它不解析这类注释，只认真实项目元数据
最容易被忽略的是：VSCode 的 Java 支持高度依赖路径的精确性——path 多一个斜杠、少一个子目录、名字拼错大小写，都会导致整个 Java 功能链失效。与其反复重启猜错哪步，不如先用终端确认 javac -version 输出路径，再原样复制进 java.configuration.runtimes。
