需分三步验证：一查java -version与javac -version输出版本是否一致；二验java_home是否指向jdk根目录且含bin/javac等子目录；三交叉核对ide、maven等工具所用java路径是否与java_home完全一致。

检查 JDK 安装和版本情况，不能只看 java -version 有输出就认为万事大吉——它只能说明运行环境（JRE）可用，而开发真正依赖的是完整的 JDK（含 javac 编译器和工具链）。要准确掌握安装状态，需分三步验证：命令是否可用、路径是否正确、工具链是否统一。

运行两个核心命令确认基础可用性

打开终端（Windows 用 CMD/PowerShell，macOS/Linux 用 Terminal），依次执行：

• java -version：应输出类似 openjdk version "21.0.2" 或 java version "17.0.1" 的信息，代表运行时环境就绪；
• javac -version：应输出对应版本号，如 javac 21.0.2，且主版本号须与上一条一致。

若 javac 报 “command not found” 或 “不是内部或外部命令”，说明可能只装了 JRE，或 JDK 的 bin 目录未加入系统 PATH。

检查 JAVA_HOME 是否指向正确的 JDK 根目录

JAVA_HOME 是 Maven、Gradle、IDE 等工具识别 JDK 的关键变量，它必须指向 JDK 安装的最外层目录（不含 /bin 或 /jre）：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

• Windows：运行 echo %JAVA_HOME%，应返回类似 C:\Program Files\Java\jdk-21.0.2；
• macOS/Linux：运行 echo $JAVA_HOME，应返回类似 /Library/Java/JavaVirtualMachines/jdk-21.0.2.jdk/Contents/Home 或 /usr/lib/jvm/java-21-openjdk-amd64。

接着手动进入该路径，确认里面存在 bin/javac、lib、conf 等标准子目录。如果指向的是 jre 子目录或 jdk-xx.jdk/Contents/Home/jre，就是错的。

交叉验证工具链是否使用同一 JDK

很多问题出在“终端能用，但 IDE 或 Maven 用的却是另一个 Java”。进一步确认：

• 运行 %JAVA_HOME%\bin\java -version（Windows）或 $JAVA_HOME/bin/java -version（macOS/Linux），必须能正常输出；
• 运行 mvn -v（需已安装 Maven），查看输出中 “Java home” 路径是否与 JAVA_HOME 完全一致；
• 在 IntelliJ IDEA 中：File → Project Structure → SDKs，确认添加的 SDK 路径等于 JAVA_HOME 值；
• 在 VS Code 中：检查设置项 java.home 是否指向同一路径。

快速列出系统所有已安装的 JDK

尤其适合多版本共存场景：

• macOS：运行 /usr/libexec/java_home -V；
• Linux（Debian/Ubuntu）：运行 update-alternatives --list java 和 update-alternatives --list javac；
• Windows：浏览 C:\Program Files\Java\，查看有哪些 jdk-* 文件夹；
• 通用定位：用 where java（Windows）或 which java（macOS/Linux）查可执行文件路径，再向上推两级目录即为 JDK 根目录。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南