在 MacOS 上安装 JDK 后，有时会遇到终端无法识别 java 命令的问题，即使手动配置了 ~/.bash_profile 或 ~/.zshrc 中的 JAVA_HOME 环境变量也无法生效，提示 Unable to locate a Java Runtime。本文记录这一问题的完整解决方案。核心内容包括：从华为云镜像站下载 jdk-11.0.2_osx-x64_bin.dmg 安装包，完成 JDK 安装后，通过正确配置环境变量（针对不同 shell 配置文件）使 java 命令可在终端中正常使用。

本文适用于在 MacOS 上安装 JDK 时遇到环境变量配置问题的开发者。

错误信息

shell
odboy@odboydeMacBook-Pro ~ % java
The operation couldn’t be completed. Unable to locate a Java Runtime.
Please visit http://www.java.com for information on installing Java.

下载地址

华为云

安装后