JAVA_HOME未正确配置是VS Code无法识别JDK的根本原因，它必须指向JDK根目录（非bin子目录），且java -version与javac -version均需成功验证；插件优先读取系统JAVA_HOME，失败才回退到settings.json中的java.home设置。
JAVA_HOME 没配对，VS Code 就认不出 JDK
VS Code 本身不带 Java 运行时，它依赖系统级的 JAVA_HOME 才能定位编译器和调试器。很多人装完插件发现“Run”按钮灰掉、Java: Configure Java Runtime 列表为空，根本原因就是这一步没走通。
常见错误现象：java -version 能输出，但 javac -version 报“不是内部或外部命令”；或者 VS Code 提示 “The java.home variable is not set”。
- Windows：必须新建「系统变量」
JAVA_HOME，值为 JDK 根目录（如C:Program FilesEclipse Adoptiumjdk-17.0.9.9-hotspot），不是bin子目录 - macOS/Linux：在
~/.zshrc或~/.bash_profile中写两行，注意等号两侧不能有空格：export JAVA_HOME=/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home和export PATH=$JAVA_HOME/bin:$PATH - 验证必须用两个命令：
java -version和javac -version都成功才算到位
Extension Pack for Java 安装后仍报错 JDK 版本不兼容
插件包里最关键的 Language Support for Java™ by Red Hat 从 0.65.0 版本起已放弃对 Java 8 的支持。如果你用的是 jdk1.8.0_201，即使 JAVA_HOME 正确，插件也会反复弹窗提示“Please install JDK 11+”。
解决路径只有两条：
立即学习“Java免费学习笔记（深入）”；
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
- 升级 JDK：优先选 Eclipse Temurin 的 JDK 17（LTS）或 JDK 21（最新 LTS），下载地址是
https://adoptium.net/ - 降级插件（不推荐）：手动卸载当前
Language Support for Java™，再从 Marketplace 安装旧版（如 0.64.x），但会失去语义高亮、Lombok 支持等新特性 - 别信“只配
java.home就够了”的说法——插件启动时先查系统JAVA_HOME，再查java.home设置，前者失败才会 fallback。所以环境变量是底线，不是可选项
vscode settings.json 里 java.home 路径写错的三种典型情况
java.home 是 VS Code 插件找 JDK 的第二道门，但写错路径比想象中容易得多。尤其 Windows 用户常在这里栽跟头。
- 反斜杠没转义：写成
"java.home": "C:Program Files...jdk-17"→ 必须双写反斜杠："java.home": "C:\Program Files\...\jdk-17" - 路径末尾多了
in：值应是 JDK 根目录，不是bin目录，否则插件找不到jdt.ls服务端 - 用了符号链接或 OneDrive 同步路径：Temurin 官方安装包生成的路径含空格和版本号（如
jdk-17.0.9.9-hotspot），直接复制粘贴最稳；避免用C:UsersXXXAppDataLocalProgramsAdoptium...这类可能被重定向的路径
运行 Java 文件前，先确认项目结构是否被识别
新建一个 Hello.java 文件，按 Ctrl+F5 却提示 “No Java runtime configured”，往往不是环境问题，而是 VS Code 没把它当 Java 项目处理。
触发识别的关键动作：
- 文件必须保存为
.java后缀，且内容含public class声明（类名需与文件名一致） - 如果项目根目录下有
pom.xml或build.gradle，Maven/Gradle 插件会自动激活；否则需手动执行Java: Create Java Project命令生成标准结构（含src/main/java） - 不要把 Java 文件丢在桌面或任意文件夹里直接打开——VS Code 默认以“文件模式”加载，不会启动 Java 语言服务器；应通过「File → Open Folder」打开整个项目根目录
最易被忽略的一点：插件启动 jdt.ls 语言服务器需要几秒冷启动时间，刚打开项目就急着运行，大概率失败。看左下角状态栏出现 “Java Language Server” 并显示“Ready”，才是真就绪。
