对于绝大多数 Mac 用户,最推荐、最简单的方式是使用 Homebrew 包管理器来安装,它会自动处理路径配置等问题。
如果您需要特定版本(如 Oracle JDK、Amazon Corretto、Eclipse Temurin 等),或者不想使用 Homebrew,可以直接从官方下载安装包。
使用 Homebrew(强烈推荐)
Homebrew 是 macOS 上最流行的包管理工具,可以让你像在 Linux 上一样轻松地安装各种软件。
安装 Homebrew(如果尚未安装)
打开您的“终端”(Terminal,可以在“应用程序” > “实用工具”里找到,或使用 Spotlight 搜索 cmd + 空格)。
在终端中输入以下命令并回车:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
根据提示输入您的 Mac 密码(输入时屏幕上不会显示任何内容,这是正常的),然后等待安装完成。
使用 Homebrew 安装 JDK
Homebrew 提供了多个版本的 JDK,其中最流行的是 Eclipse Temurin(由社区维护,免费,包含最新的 OpenJDK 特性)。
安装最新版本的 JDK (JDK 21):
brew install openjdk@21
如果您需要其他版本,可以替换 21,openjdk@17, openjdk@11 等。
配置环境变量
Homebrew 通常会提示你如何配置环境变量,请务必按照终端输出的提示进行操作。
你需要将 JDK 的 bin 目录添加到 PATH 环境变量中,对于 Apple Silicon (M1/M2/M3) Mac 和 Intel Mac,路径不同。
对于 Apple Silicon Mac (M1/M2/M3):
echo 'export PATH="/opt/homebrew/opt/openjdk@21/bin:$PATH"' >> ~/.zshrc
对于 Intel Mac:
echo 'export PATH="/usr/local/opt/openjdk@21/bin:$PATH"' >> ~/.zshrc
注意:
- 请将
21替换为你安装的 JDK 版本号。- 如果您使用的是 Bash 而不是 Zsh(macOS Catalina 之后的默认 Shell),请将
~/.zshrc替换为~/.bash_profile。
配置完成后,重启终端或运行 source ~/.zshrc (或 source ~/.bash_profile) 使配置生效。
验证安装
在新的终端窗口中,输入以下命令:
java -version javac -version
如果能看到版本信息,java 和 javac 命令都能正常工作,说明安装成功。
直接从官网下载安装
如果您不使用 Homebrew,或者需要特定厂商的 JDK(如 Oracle JDK),可以直接下载。
选择并下载 JDK
主流的 JDK 发行版有:
| 发行版 | 官网地址 | 特点 |
|---|---|---|
| Eclipse Temurin | https://adoptium.net/ | (首选) 社区驱动,免费,包含最新 OpenJDK,对个人和企业用户都友好。 |
| Oracle JDK | https://www.oracle.com/java/technologies/downloads/ | Oracle 官方版本,需要接受 OTN 许可协议,某些商业用途可能需要付费。 |
| Amazon Corretto | https://aws.amazon.com/corretto/ | AWS 提供的、长期支持(LTS)的 OpenJDK 版本,免费稳定。 |
| Microsoft Build of OpenJDK | https://www.microsoft.com/openjdk/ | 微软提供的 OpenJDK 构建,提供长期支持。 |
以 Eclipse Temurin 为例:
- 访问 https://adoptium.net/。
- 点击 "Temurin JDK"。
- 在 "Latest Releases" 或 "LTS Releases" 中选择你需要的版本(如 JDK 21, 17 等)。
- 选择你的操作系统为 macOS,架构为 x64 (Intel Mac) 或 aarch64 (Apple Silicon Mac)。
- 点击下载按钮,下载
.pkg安装包。
安装 JDK
- 找到下载的
.pkg文件,双击打开。 - 按照安装向导的提示一步步操作即可,它会自动将 JDK 安装到系统的标准位置(如
/Library/Java/JavaVirtualMachines/)。
配置环境变量(手动)
直接下载安装包通常不会自动配置好 JAVA_HOME 和 PATH,你需要手动配置。
-
找到 JDK 安装路径 在终端中运行以下命令,可以找到最新安装的 JDK 路径:
/usr/libexec/java_home -V
你会看到类似下面的输出,找到你安装的 JDK 版本对应的路径:
Matching Java Virtual Machines (2): 21.0.2 (x86_64) "Oracle Corporation" - "OpenJDK 21.0.2" /Library/Java/JavaVirtualMachines/openjdk-21.jdk/Contents/Home 1.8.0_342 (x86_64) "Apple Inc." - "Java SE 8" /Library/Java/JavaVirtualMachines/jdk1.8.0_342.jdk/Contents/Home假设我们要使用 OpenJDK 21,那么路径就是
/Library/Java/JavaVirtualMachines/openjdk-21.jdk/Contents/Home。 -
配置 Shell 配置文件 同样,根据你的 Shell 类型(Zsh 或 Bash),编辑对应的配置文件。
# 对于 Zsh (macOS Catalina 之后默认) open -e ~/.zshrc # 对于 Bash (旧版 macOS) open -e ~/.bash_profile
-
添加环境变量 在打开的文件末尾添加以下内容(请务必将路径替换为你自己找到的路径):
# 设置 JDK 21 的 JAVA_HOME export JAVA_HOME=/Library/Java/JavaVirtualMachines/openjdk-21.jdk/Contents/Home # 将 JDK 的 bin 目录添加到 PATH export PATH=$JAVA_HOME/bin:$PATH
-
使配置生效 保存文件后,重启终端或运行
source ~/.zshrc(或source ~/.bash_profile)。
验证安装
与方法一相同,在终端中运行:
java -version javac -version
确认输出正确。
常见问题 (FAQ)
Q: 我应该选择哪个版本的 JDK? A:
- 新手/新项目:选择最新的 LTS (长期支持) 版本,如 JDK 17 或 JDK 21,它们更稳定,性能更好,安全性更高。
- 维护旧项目:根据项目要求,使用与之匹配的版本,如 JDK 8, JDK 11 等。
Q: java -version 显示了多个版本,如何切换?
A: macOS 的 /usr/libexec/java_home 命令可以方便地管理多个 JDK 版本。
- 使用
export JAVA_HOME=$(/usr/libexec/java_home -v 21)可以临时切换到 JDK 21。 - 你也可以在
~/.zshrc或~/.bash_profile中创建一个别名(alias)来快速切换,alias setjdk17='export JAVA_HOME=$(/usr/libexec/java_home -v 17)' alias setjdk21='export JAVA_HOME=$(/usr/libexec/java_home -v 21)'
重启终端后,只需输入
setjdk21即可切换到 JDK 21。
Q: 什么是 JAVA_HOME?
A: JAVA_HOME 是一个环境变量,指向 JDK 的安装根目录,很多 Java 应用服务器、构建工具(如 Maven, Gradle)都需要通过这个变量来找到 JDK。
希望这份指南能帮助您顺利在 Mac 上安装 Java SDK!
