在 Mac 上安装 Java 的几种方法

主要有三种主流方法,您可以根据自己的需求选择：

1. 使用 Homebrew (推荐给大多数用户): Homebrew 是 macOS 最受欢迎的包管理器，它简单、快速，并且能很好地管理依赖。
2. 手动下载安装包: 适合需要特定版本或不想安装额外工具的用户。
3. 使用 SDKMAN! (适合高级开发者): 一个强大的命令行工具，可以轻松地在多个 Java 版本之间切换。

使用 Homebrew (最推荐)

这是最简单、最省心的方式，尤其适合新手。

步骤 1: 安装 Homebrew

如果您已经安装了 Homebrew，请跳过此步。

打开 终端 (Terminal)，您可以在 应用程序 -> 实用工具 中找到，或者使用 Spotlight 搜索 (Command + 空格键 输入 "Terminal")。

然后输入以下命令并回车：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装过程可能需要一些时间,请耐心等待，根据您的网络状况，可能需要配置代理。

步骤 2: 使用 Homebrew 安装 Java

Homebrew 提供的 Java 包是由社区维护的，非常稳定，我们安装 openjdk，这是 Oracle OpenJDK 的开源版本。

在终端中运行：

brew install openjdk

默认情况下,这会安装最新的 LTS (长期支持) 版本，Java 17 或 Java 21。

步骤 3: 配置环境变量

安装完成后,Homebrew 会提示你如何设置环境变量。请务必仔细阅读终端的输出信息。

它会输出类似下面的内容：

# For Apple Silicon Macs (M1, M2, M3...)
echo 'export PATH="/opt/homebrew/opt/openjdk/bin:$PATH"' >> ~/.zshrc
# For Intel-based Macs
echo 'export PATH="/usr/local/opt/openjdk/bin:$PATH"' >> ~/.zshrc

您需要根据您的 Mac 芯片类型执行对应的命令，这个命令的作用是将 Java 的可执行文件路径添加到您的 Shell 配置文件中，这样您就可以在任何地方使用 java, javac 等命令。

执行后,为了让配置立即生效，运行：

source ~/.zshrc

(如果您使用的是 Bash Shell，则文件是 ~/.bash_profile，命令是 source ~/.bash_profile)

手动下载安装包

如果您不想使用 Homebrew，或者需要一个非常特定的版本。

步骤 1: 下载 Java

1. 访问 Oracle 官方下载页面或 Eclipse Temurin (Adoptium) 社区版下载页面。
   • Oracle JDK: https://www.oracle.com/java/technologies/downloads/
   • Eclipse Temurin (推荐): https://adoptium.net/ (完全开源，免费，与 Oracle JDK 兼容)
2. 选择您需要的 macOS 版本 (macOS x64, macOS aarch64 for Apple Silicon) 和 Java 版本，然后下载 .dmg 安装包。

步骤 2: 安装

1. 打开下载的 .dmg 文件。
2. 将 Java 图标拖拽到 Applications 文件夹中。

步骤 3: 配置环境变量 (手动)

1. 找到 Java 安装路径：

   • Apple Silicon Mac (M1/M2/M3): 通常安装在 /Library/Java/JavaVirtualMachines/ 目录下。
   • Intel Mac: 通常也安装在 /Library/Java/JavaVirtualMachines/ 目录下。
   • 打开 Finder，前往 Macintosh HD -> Library -> Java -> JavaVirtualMachines，您会看到一个类似 jdk-17.jdk 的文件夹，记下这个文件夹的完整路径。

2. 设置环境变量：

   • 打开 终端。
   • 我们需要编辑 Shell 配置文件，如果您使用的是 macOS Catalina (10.15) 或更高版本，默认 Shell 是 Zsh，文件是 ~/.zshrc，如果是旧版 Bash，文件是 ~/.bash_profile。
   • 使用 nano 编辑器打开文件（nano 是一个简单易用的命令行编辑器）：

     nano ~/.zshrc

   • 在文件末尾添加以下两行（请将路径替换为您自己找到的路径）：

     export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home
     export PATH="$JAVA_HOME/bin:$PATH"

   • 按 Control + X，然后按 Y 保存，最后按 Enter 确认。

3. 让配置生效：

   source ~/.zshrc

使用 SDKMAN! (适合需要多版本切换的开发者)

如果您是开发者,经常需要在不同 Java 项目间切换版本，SDKMAN! 是最佳选择。

步骤 1: 安装 SDKMAN!

在终端中运行：

curl -s "https://get.sdkman.io" | bash

安装完成后,关闭并重新打开终端，或者运行：

source "$HOME/.sdkman/bin/sdkman-init.sh"

步骤 2: 使用 SDKMAN! 安装和切换 Java

1. 查看可用的 Java 版本:

   sdk list java

   这会列出所有可用的 Java 发行版（包括 Oracle, OpenJDK, Amazon Corretto 等）。

2. 安装一个 Java 版本:

   # 安装最新的 LTS 版本
   sdk install java 17.0.8-tem
   # 或者安装一个非 LTS 版本
   sdk install java 21.0.1-tem

   tem 代表 Eclipse Temurin。

3. 切换默认 Java 版本:

   # 使用默认版本
   sdk default java 17.0.8-tem
   # 或者指定版本
   sdk use java 21.0.1-tem

SDKMAN! 会自动处理 JAVA_HOME 和 PATH 的配置，非常方便。

如何验证 Java 是否安装成功

无论您使用哪种方法,安装完成后都需要进行验证。

1. 打开终端。

2. 检查 Java 版本:

   java -version

   如果安装成功,您会看到类似下面的输出，显示您安装的 Java 版本信息：

   openjdk version "17.0.8" 2025-07-18
   OpenJDK Runtime Environment Temurin-17.0.8+7 (build 17.0.8+7)
   OpenJDK 64-Bit Server VM Temurin-17.0.8+7 (build 17.0.8+7, mixed mode, sharing)

3. 检查 Java 编译器版本:

   javac -version

   这会检查 Java 编译器是否可用，版本应与 java -version 一致。

4. 检查 JAVA_HOME 环境变量:

   echo $JAVA_HOME

   这会输出当前设置的 JAVA_HOME 路径，如果为空或路径错误，说明环境变量配置可能有问题。

常见问题与解决方案

• 问题: zsh: command not found: java

  • 原因: 环境变量未配置或配置错误。
  • 解决: 回到您使用的安装方法，重新检查并配置环境变量，确保执行了 source 命令。

• 问题: 安装了多个 Java 版本，如何切换？

  • 使用 Homebrew: brew unlink openjdk@17 && brew link openjdk@21 (假设要切换到 21)。
  • 使用 SDKMAN!: sdk use java <version> 是最简单的方式。
  • 手动: 修改 ~/.zshrc 中的 JAVA_HOME 路径，source ~/.zshrc。

• 问题: 在 IntelliJ IDEA 或 VS Code 中 Java 环境未识别。

  • 原因: IDE 使用的环境变量可能与终端不一致。
  • 解决: 在 IDE 的设置中，手动指定 JDK 路径，路径通常是 JAVA_HOME 指向的目录，/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home。

希望这份详细的指南能帮助您成功在 MacBook 上搭建好 Java 开发环境！