本指南将会指引你在 macOS 上安装 Java 21。

Minecraft 启动器自带 Java 安装，因此本节仅在你想要使用 Fabric 的 .jar 安装程序，或想要使用 Minecraft 服务器 .jar 时才相关。

1. 检查 Java 是否已经安装

在终端（位于 /Applications/Utilities/Terminal.app）中输入以下命令，然后按 Enter 键：

$(/usr/libexec/java_home -v 21)/bin/java --version

你应该会看到类似以下内容：

openjdk 21.0.9 2025-10-21 LTS
OpenJDK Runtime Environment Temurin-21.0.9+10 (build 21.0.9+10-LTS)
OpenJDK 64-Bit Server VM Temurin-21.0.9+10 (build 21.0.9+10-LTS, mixed mode, sharing)

请注意版本号：在上例中，版本号为 21.0.9。

WARNING

要使用 Minecraft 1.21.11，你至少需要安装 Java 21。

如果这条命令输出的版本低于21，你就需要更新你已安装的Java；请继续阅读这篇文章。

2. 下载并安装 Java 21

我们推荐使用 Adoptium 构建的 OpenJDK 21：

请务必选择“21 - LTS”版本，并选择 .PKG 安装程序格式。 你还应根据你系统的芯片选择正确的架构：

• 如果你使用的是 Apple M 系列芯片，请选择 aarch64（默认）
• 如果你使用的是 Intel 芯片，请选择 x64
• 请按照此说明了解你的 Mac 中安装的是哪种芯片

下载 .pkg 安装程序后，打开它并按照提示操作：

你需要输入管理员密码才能完成安装：

使用 Homebrew

如果你已经安装了 Homebrew，则可以改用 brew 安装 Java 21：

brew install --cask temurin@21

3. 验证是否已安装 Java 21

安装完成后，你可以再次打开终端并输入 $(/usr/libexec/java_home -v 21)/bin/java --version 来验证 Java 21 是否已安装。

如果命令执行成功，你应该会看到类似这样的输出：

openjdk 21.0.9 2025-10-21 LTS
OpenJDK Runtime Environment Temurin-21.0.9+10 (build 21.0.9+10-LTS)
OpenJDK 64-Bit Server VM Temurin-21.0.9+10 (build 21.0.9+10-LTS, mixed mode, sharing)

如果你有任何问题，欢迎在Fabric Discord的#player-support频道中提问。