VS Code报“JAVA_HOME not found”是因GUI启动不继承shell环境变量，需用终端启动、正确配置java.home指向JDK根目录、修复bin/java执行权限，并执行Java: Configure Java Runtime重载语言服务器。
java -version 正常但 VS Code 仍报“JAVA_HOME not found”
这是最典型的「环境分裂」现象：终端里 java -version 和 javac -version 都能跑，但 VS Code 状态栏不显示 JDK 版本，Language Server 启动失败。根本原因是 GUI 启动的 VS Code 不继承 shell 的环境变量（尤其是 JAVA_HOME）。
验证方法：在 VS Code 内置终端中执行 echo $JAVA_HOME（macOS/Linux）或 echo %JAVA_HOME%（Windows CMD），结果为空即确认该问题。
- macOS 用户别用 Dock 或 Spotlight 启动 VS Code，改用终端命令：
open -n -b "com.visualstudio.code" --args - Windows 用户避免双击快捷方式，改用 PowerShell 运行：
code（前提是已将 VS Code 加入 PATH） - Linux 用户若用桌面启动器（.desktop 文件），需在
Exec=行前加env JAVA_HOME=/path/to/jdk-17
settings.json 中 java.home 路径写错或权限不足
java.home 必须指向 JDK 安装目录的根，不是 bin/、不是 jre/、也不能是软链接未解析的路径。OpenJDK 官方 tar.gz 包解压后，bin/java 常无执行权限，会导致 Language Server 启动时静默失败。
检查命令：ls -l $(readlink -f $JAVA_HOME)/bin/java，若无 x 权限，会直接卡在 “Failed to launch JVM”。
- 正确路径示例：
"java.home": "/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home"（macOS） - 错误路径示例：
"java.home": "/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home/bin"（多了一级 bin） - 修复权限（Linux/macOS）：
chmod +x /path/to/jdk-17/bin/*
Java Extension Pack 未重载配置，或 runtime 列表未刷新
修改 settings.json 或系统 JAVA_HOME 后，VS Code 不会自动重启 Java Language Server（jdt.ls）。你看到的状态栏版本可能是旧缓存，调试器仍用着上一轮加载的 JVM。
必须手动触发重载：按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入并执行 Java: Configure Java Runtime。这个命令不只是打开设置面板，它会强制终止并重启 jdt.ls 进程。
- 执行后观察输出通道（Output → Java）是否出现
Starting Java Language Server新日志 - 若仍失败，可临时禁用再启用
Extension Pack for Java，比单纯重载更彻底 - 注意
java.configuration.runtimes数组中"default": true是否落在目标 JDK 上，否则可能被自动 fallback 到旧版本
OpenJDK 安装包本身缺 src.zip 或 legal/ 目录导致源码跳转失败
VS Code 的 Ctrl+Click 跳转到 JDK 类（如 String）失败，或提示 No source found，往往不是配置问题，而是 OpenJDK 发行版没附带源码包。Adoptium、Eclipse Temurin 官方构建默认不含 src.zip，而 Red Hat Java 扩展依赖它做语义分析。
验证方法：检查 $JAVA_HOME/src.zip 是否存在；不存在则跳转必然失败，且部分代码补全能力降级。
- Temurin 用户可单独下载对应版本的
jdk-17+xx-src.zip，解压后手动复制进$JAVA_HOME根目录 - Homebrew（macOS）用户安装时加
--with-jdk-src-zip参数（若支持） - Linux 用户可用
apt install openjdk-17-source（Ubuntu/Debian）或dnf install java-17-openjdk-src（Fedora/RHEL）
真正卡住人的，往往是 java.home 路径看着对、权限也加了、环境变量也设了，但忘了执行 Java: Configure Java Runtime——扩展不会自己感知磁盘变化，它只认自己启动那一刻读到的配置。
