在 macOS 上安装 Java 开发环境需安装 JDK(如 JDK 17/21),推荐 Eclipse Temurin 或 Homebrew;正确配置 JAVA_HOME 指向 JDK 根目录,并将 $JAVA_HOME/bin 加入 PATH;验证 java -version 与 javac -version 一致;IDE 和构建工具通常自动识别,必要时手动指定 JDK 路径。

在 macOS 上安装 Java 开发环境,核心是装好 JDK(Java Development Kit),而不是仅装 JRE;同时要正确配置 JAVA_HOME 和 PATH,否则命令行和 IDE 都可能识别不到 Java。
选择并安装合适版本的 JDK
macOS 不再预装 Java,需手动安装。推荐使用 LTS 版本(如 JDK 17 或 JDK 21),兼顾稳定性与新特性支持。Oracle JDK 需登录下载,而 OpenJDK 更开放:
- 从 Eclipse Temurin(原 AdoptOpenJDK) 下载 .pkg 安装包,双击运行即可完成安装
- 或用 Homebrew:执行
brew install openjdk@21(会自动链接到/opt/homebrew/opt/openjdk@21) - 注意 Apple Silicon(M1/M2/M3)芯片建议选 aarch64 架构版本,Intel 芯片选 x64
正确设置 JAVA_HOME 环境变量
JAVA_HOME 必须指向 JDK 根目录(不是 bin 子目录),且路径要准确。macOS 使用 zsh 作为默认 shell,配置文件为 ~/.zshrc:
- 查看已安装 JDK 列表:
/usr/libexec/java_home -V - 根据输出选一个路径(如
/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home),写入~/.zshrc: -
export JAVA_HOME=$(/usr/libexec/java_home -v 21)(推荐用命令动态获取,避免硬编码) - 保存后执行
source ~/.zshrc生效
确保 java 命令可用
仅设 JAVA_HOME 不够,还需把 $JAVA_HOME/bin 加入 PATH,否则终端输入 java 或 javac 会提示“command not found”:
立即学习“Java免费学习笔记(深入)”;
- 在
~/.zshrc中添加:export PATH=$JAVA_HOME/bin:$PATH - 运行
source ~/.zshrc,再执行java -version和javac -version验证是否一致 - 若两者版本不同,说明系统可能混用了多个 JDK,需检查
which java和which javac的路径是否都来自$JAVA_HOME/bin
IDE 和其他工具的适配要点
IntelliJ IDEA、VS Code、Eclipse 等工具通常能自动探测 JDK,但有时仍需手动指定:
- IntelliJ:Preferences → Project → Project SDK → Add JDK → 选择
$JAVA_HOME对应路径 - VS Code + Extension Pack for Java:按 Cmd+Shift+P → “Java: Configure Java Runtime” → 设置 JDK 位置
- Maven/Gradle 项目默认读取
JAVA_HOME,无需额外配置;但可通过mvn -version确认实际使用的 JDK 版本










