Skip to content

macOS JDK 安装

macOS 用户最常遇到的问题:Homebrew 安装后 java 命令找不到、Apple Silicon 和 Intel 芯片选错版本。Homebrew 是 macOS 最方便的包管理器,可以一键安装并自动配置。

方式一:Homebrew 安装(推荐)

bash
# 安装 OpenJDK 17
brew install openjdk@17

# 安装 OpenJDK 21
brew install openjdk@21

# 创建符号链接
sudo ln -sfn $(brew --prefix)/opt/openjdk@17/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk-17.jdk

Apple Silicon vs Intel:Apple Silicon (M1/M2/M3) 选择 ARM64 版本,Intel Mac 选择 x64 版本。Adoptium 安装包会自动检测。

方式二:手动安装

  1. 下载 JDK:Adoptium(推荐)或 Oracle
  2. 双击 PKG 文件完成安装,默认路径:/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home

配置环境变量

编辑 ~/.zshrc

bash
echo 'export JAVA_HOME=$(/usr/libexec/java_home)' >> ~/.zshrc
echo 'export PATH=$JAVA_HOME/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

验证安装

bash
java -version
javac -version
echo $JAVA_HOME

多版本切换

bash
# 查看已安装的 JDK
/usr/libexec/java_home -V

# 手动指定版本
export JAVA_HOME=$(/usr/libexec/java_home -v 21)

常见报错

Homebrew 安装后 java 命令找不到 — 执行符号链接命令,配置环境变量并 source ~/.zshrc

Apple Silicon 选择哪个版本 — Adoptium 下载页会自动检测,点击 macOS ARM64 即可。

后续可阅读:安装 IntelliJ IDEA配置环境变量详解编写第一个 Java 程序

基于 VitePress 构建