java.home配置错误是VSCode编译失败的根源，必须指向含javac的完整JDK根目录（非JRE或bin子目录），路径不能含空格/中文，且需通过“Java: Configure Java Runtime”手动添加并重启生效。
java.home 配置错是编译失败的根源
VSCode 本身不带 JDK，java.home 指向错误或未设置，会导致 The java.home variable is not set、Cannot resolve JDK 或右键 Run Java 灰掉等现象。这不是“没装 JDK”，而是 VSCode 找不到它——尤其当你装了多个 JDK（Android Studio 自带、系统预装 OpenJDK、手动下载的 JDK 17/21）时，自动探测极易失效。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 终端运行
which java（macOS/Linux）或where java（Windows），再执行java -XshowSettings:properties -version 2>&1 | grep "java.home"，确认当前 shell 实际生效的 JDK 根路径 - 在 VSCode 中按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Java: Configure Java Runtime，点击Add JDK，填入上一步拿到的完整路径（例如/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home或C:\Program Files\Java\jdk-21） - 务必指向
JDK目录（含bin/javac），不是 JRE；路径中避免中文、空格、符号链接
Extension Pack for Java 别全开
官方 Extension Pack for Java 是合集，不是单个插件。轻量级开发下，全启用反而拖慢启动、触发误报、干扰单文件调试逻辑。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 只保留三项核心扩展：
Extension Pack for Java（注意名称）、Language Support for Java、Debugger for Java - 禁用不用的：如不写 Maven 项目，关掉
Maven for Java；不跑单元测试，停用Test Runner for Java - 检查设置项
java.configuration.updateBuildConfiguration是否为interactive，避免它偷偷改你的pom.xml或build.gradle
单 .java 文件运行必须右键 Run Java
新建 HelloWorld.java 后点右上角 ▶️ 没反应？那是 VSCode 默认把它当“无项目”处理，跳过了 JDK 探测流程。顶部菜单栏的 Run → Run Without Debugging 对单文件无效。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 务必右键文件编辑区 → 选择
Run Java（不是“Run Java File”或其它变体） - 若写了
package demo;，文件必须放在demo/HelloWorld.java子目录下；否则删掉package声明，且文件不能嵌套在多层子目录中 - 临时调试可加
.vscode/settings.json，内容仅一行：{"java.home":"/path/to/your/jdk"}，路径需绝对、正确
JDK 版本和插件兼容性要对齐
Language Support for Java（Red Hat 提供）新版已放弃 JDK 8 支持。如果你用的是 JDK 8，装最新版插件会持续弹窗提示“请升级到 JDK 11”，且语言功能异常。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 优先用 JDK 11 或更高版本（JDK 17/21 更稳妥），避免降级插件版本这种易出错操作
- 若必须用 JDK 8，请手动安装旧版
Language Support for Java（v0.64.x 或更早），并在插件设置中关闭java.requirements.JDK11Warning - 别信“装了 JDK 就能用”的直觉——VSCode 的 Java 插件依赖 JDK 的特定模块（如
jdk.compiler），JRE 或精简版 JDK 无法通过校验
最常被忽略的其实是路径有效性：哪怕 java -version 能输出，java.home 指向的目录里若没有 lib/rt.jar（JDK 8）或 lib/modules（JDK 9+），插件依然会静默失败。动手前先 ls $YOUR_JDK_HOME/lib 看一眼。
