Java SDK Mac 安装教程

在 macOS 系统中安装和配置 Java 开发环境,是每一位 Java 开发者入门与进阶的必经之路。尽管 Apple 自 macOS Catalina(10.15)起移除了对 Java 的内置支持,但 Java 作为跨平台、高稳定性的企业级语言,其生态持续繁荣。尤其在微服务、大数据、云原生等场景中,Java 仍是主力语言之一。本教程以当下主流版本(JDK 8/11/17/21)为核心,提供一套系统、严谨、可复现的 Mac 安装方案,覆盖从零配置、版本管理、工具链集成到故障排查全流程。

近年来,随着 OpenJDK 社区的活跃,Adoptium(原 AdoptOpenJDK)、Amazon Corretto、Oracle JDK、Azul Zulu、Red Hat OpenJDK 等发行版并存,各具优势:例如 Corretto 免费且无审计条款限制;Adoptium 提供高兼容性与 OpenJDK 原生体验;Zulu 支持更多企业级特性。用户可根据项目需求、合规性、性能倾向灵活选择。本教程以 Adoptium Temurin(Eclipse Temurin)为主推,因其开源透明、长期支持稳定、社区活跃、macOS 架构支持全面(含 Apple Silicon M1/M2/M3)。

值得注意的是,macOS 版本更新(如 macOS Sonoma 14、Sequoia 15)对 Java 安全策略存在影响。例如,非 Notarized 或非不签名的 JDK 可能触发 Gatekeeper 阻断。本教程特别提供绕过方案与签名验证检查步骤,确保安装流程“零阻塞”。此外,随着 Apple Silicon 芯片普及,JDK 的 Arm64 架构支持已趋于成熟——JDK 16+ 原生支持 ARM,而 JDK 8/11 需选用 aarch64 构建版本(如 Temurin 的 “aarch64” 后缀包)。

📌 为何选择 Temurin(Eclipse Temurin)?

Temurin 是 Eclipse 基金会主导的 OpenJDK 发行版,具有以下优势:

  • 完全开源,源码可查,无隐藏行为;
  • 提供 macOS x86_64 与 aarch64(ARM)双架构安装包;
  • 支持长期支持(LTS)版本:JDK 8、11、17、21;
  • 提供 JRE、HotSpot、OpenJ9(内存占用更低)多种运行时;
  • 兼容 Apple Silicon,经官方测试验证;
  • 支持 Homebrew、SDKMAN!、jenv 等主流管理工具。

官网:https://adoptium.net/|文档:https://adoptium.net/docs/

一、JDK 安装全流程(图形界面 & 命令行)

1.1 图形安装(推荐新手)

以 macOS Sonoma 14.5 + Temurin JDK 17(aarch64) 为例:

  1. 访问 Adoptium Releases 页面;
  2. 点击 macOS → ARM 64-bit(M1/M2/M3 芯片),选择 LTS 版本(如 17.0.12+7);
  3. 下载 .pkg 安装包(如 OpenJDK17U-jdk_aarch64_mac_hotspot_17.0.12_7.pkg);
  4. 双击运行安装包,按提示完成安装(默认路径:/Library/Java/JavaVirtualMachines/temurin-17.jdk);
  5. 如遇“无法验证开发者”提示,前往「系统设置」→「隐私与安全性」→「安全性」→ 点击「仍要打开」。
⚠️ 注意:Apple Silicon 芯片请勿误选 x86_64(Intel)版本!否则将通过 Rosetta 2 转译运行,性能下降约 15%~25%。

1.2 命令行安装(自动化部署首选)

使用 Homebrew 安装 Temurin,支持一键安装多版本:

brew install --cask temurin

安装指定版本(如 JDK 21):

brew install --cask temurin21

查看已安装版本:

ls /Library/Java/JavaVirtualMachines/

输出示例:

temurin-8.jdk
temurin-11.jdk
temurin-17.jdk
temurin-21.jdk

若未安装 Homebrew,请先执行:

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

💡 提示:ARM 与 Intel 架构包区别

下载时务必确认文件名后缀:

架构类型 文件名关键词 适用设备 运行效率
aarch64(ARM64) aarch64 Apple Silicon(M1/M2/M3) 原生运行,性能最优
x86_64(Intel) x64 Intel Mac 原生运行
x86_64 + Rosetta x64 + M 系列芯片 M 系列芯片(兼容模式) 转译运行,性能损失

二、安装验证与路径确认

安装完成后,需验证 JDK 是否被系统正确识别,并确认实际生效路径(避免多版本冲突):

2.1 基础命令验证

java -version
javac -version

预期输出(以 JDK 17 为例):

openjdk version "17.0.12" 2024-07-16
OpenJDK Runtime Environment Temurin-17.0.12+7 (build 17.0.12+7)
OpenJDK 64-Bit Server VM Temurin-17.0.12+7 (build 17.0.12+7, mixed mode)

若提示 command not found,说明 PATH 未正确配置,需跳转至「环境变量配置」章节。

2.2 确认实际 JDK 路径

which java
/usr/libexec/java_home -V

/usr/libexec/java_home -V 是 macOS 特有的权威路径查询命令,输出所有已注册 JDK:

Matching Java Virtual Machines (5):
    21.0.3 (arm64) "Eclipse Adoptium" - "OpenJDK 21.0.3" /Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home
    17.0.12 (arm64) "Eclipse Adoptium" - "OpenJDK 17.0.12" /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home
    11.0.24 (arm64) "Eclipse Adoptium" - "OpenJDK 11.0.24" /Library/Java/JavaVirtualMachines/temurin-11.jdk/Contents/Home
    1.8.0_412 (arm64) "Eclipse Adoptium" - "OpenJDK 8" /Library/Java/JavaVirtualMachines/temurin-8.jdk/Contents/Home
    1.7.0_80 (x86_64) "Oracle Corporation" - "Java SE 7" /Library/Java/JavaVirtualMachines/jdk1.7.0_80.jdk/Contents/Home
/Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home

最后一行显示默认版本路径,可配合 -v 参数切换指定版本:

java -version -v 17
# 或
/usr/libexec/java_home -v 17 --exec javac -version

2.3 检查架构是否匹配

file $(which java)

正确输出应含 arm64(M 系列芯片):

/usr/bin/java: Mach-O 64-bit executable arm64

若为 x86_64,则可能是 Intel JDK 或通过 Rosetta 运行,需重新安装。

三、环境变量深度配置(PATH / JAVA_HOME / JRE_HOME)

macOS 默认不自动将 JDK 加入 PATH,需手动配置。推荐使用 ~/.zshrc(macOS Catalina+ 默认 Shell),而非 ~/.bash_profile。

3.1 创建配置脚本

执行:

touch ~/.zshrc
open -e ~/.zshrc

在文件末尾添加(以 JDK 17 为例):

# Java SDK 环境变量(默认使用 JDK 17)
export JAVA_HOME=$(/usr/libexec/java_home -v 17)
export PATH="$JAVA_HOME/bin:$PATH"
export JRE_HOME="$JAVA_HOME/jre"
export CLASSPATH=".:$JAVA_HOME/lib:$JRE_HOME/lib"

保存后执行:

source ~/.zshrc

验证:

echo $JAVA_HOME
# 输出:/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home

3.2 多版本动态切换方案

为避免频繁修改配置文件,推荐通过函数实现一键切换:

# 多 JDK 版本管理函数
java_use() {
  local version=$1
  if [[ -z "$version" ]]; then
    echo "用法:java_use <8|11|17|21>"
    return 1
  fi
  export JAVA_HOME=$(/usr/libexec/java_home -v "$version")
  export PATH="$JAVA_HOME/bin:$PATH"
  export JRE_HOME="$JAVA_HOME/jre"
  echo "✅ 已切换至 JDK $version($JAVA_HOME)"
  java -version
}

使用方式:

java_use 8   # 切换至 JDK 8
java_use 21  # 切换至 JDK 21

该函数可写入 ~/.zshrc,实现永久生效。配合 /usr/libexec/java_home -V 可确保路径精准匹配。

四、版本管理工具:SDKMAN! 与 jenv 实战

当项目需要频繁切换 JDK(如同时开发 Java 8 与 Java 21 应用),图形安装+环境变量手动配置效率低下。此时应引入专业工具:SDKMAN!(Shell 工具)与 jenv(Java 专用)。

4.1 SDKMAN!:跨语言版本管理器

安装 SDKMAN!:

curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"

安装 Temurin 多版本:

sdk install java 17.0.12-tem
sdk install java 21.0.3-tem

列出已安装版本:

sdk list java
sdk current java

切换版本:

sdk use java 17.0.12-tem
sdk default java 21.0.3-tem

优势:

⚡ SDKMAN! 项目级自动切换示例

在项目根目录创建 .sdkmanrc:

java=21.0.3-tem

进入项目目录时自动切换至 JDK 21,退出后恢复默认版本。

4.2 jenv:专注 Java 版本切换

安装 jenv(需先安装 Homebrew):

brew install jenv

配置 Shell(添加至 ~/.zshrc):

export PATH="$HOME/.jenv/bin:$PATH"
eval "$(jenv init -)"

添加已安装 JDK:

jenv add /Library/Java/JavaVirtualMachines/temurin-8.jdk/Contents/Home
jenv add /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home
jenv add /Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home

查看已注册版本:

jenv versions

切换全局版本:

jenv global 17
jenv local 21   # 仅当前目录生效

jenv 支持 global(用户级)、shell(当前终端会话)、local(目录级)三层作用域,灵活应对复杂开发场景。

五、IDE 配置:IntelliJ IDEA & VS Code 深度集成

5.1 IntelliJ IDEA

IDEA 默认使用系统 JDK,但可通过设置强制指定:

  1. 新建项目 →「Project SDK」→「New...」→「JDK」;
  2. 路径选择:/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home;
  3. 「Project Structure」→「Modules」→「Dependencies」确保 SDK 正确;
  4. 「Build, Execution, Deployment」→「Build Tools」→「Maven/Gradle」→「JDK for importer」设为相同版本。

重要提示:在「Preferences」→「Build, Execution, Deployment」→「Build Tools」→「Maven」中勾选 「Use Maven wrapper」 可避免 Maven 版本冲突。

5.2 VS Code(Code - OSS)

安装 Extension Pack for Java 后:

若项目使用 launch.json,请确保 java.home 字段指向正确路径:

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "java",
      "name": "Debug (Launch)",
      "request": "launch",
      "mainClass": "com.example.Main",
      "projectName": "my-project",
      "javaHome": "/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home"
    }
  ]
}

六、常见问题排查(FAQ)

6.1 安装后 java -version 仍报错

可能原因:

6.2 Maven/Gradle 构建失败:找不到 JDK

解决步骤:

mvn -version  # 检查 Maven 是否使用正确 JDK
gradle -v

若 Maven 使用旧版 JDK,编辑 ~/.mavenrc:

export JAVA_HOME=$(/usr/libexec/java_home -v 17)

Gradle 可设置 org.gradle.java.home:

# in ~/.gradle/gradle.properties
org.gradle.java.home=/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home

6.3 Apple Silicon 上运行 x86_64 JDK 卡顿

症状:启动慢、内存占用高、终端显示 Running under x86_64。

解决方案:

  1. 卸载现有 JDK;
  2. 下载 aarch64 版本(文件名含 aarch64);
  3. 通过「访达」→「显示简介」→「使用 Rosetta 打开」取消勾选。

🚀 网友推荐:JDK 选择速查表

使用场景 推荐版本 推荐发行版 理由
企业级后端(Spring Boot) JDK 17(LTS) Temurin / Corretto 长期支持,生态完善,性能稳定
Android 开发 JDK 11(Android Studio 默认) Temurin 与 Android Gradle 插件兼容性最佳
内存敏感型应用 JDK 17 + OpenJ9 Adoptium OpenJ9 OpenJ9 运行时内存占用降低 30%~50%
云原生/Serverless JDK 21(LTS) Corretto / Zulu 支持 Virtual Threads(Project Loom),提升并发效率

七、扩展知识:Java 版本演进与 macOS 兼容性

从 JDK 8 到 JDK 21,版本更迭伴随重大特性演进:

macOS 兼容性注意:

八、开发者工具链推荐

除 JDK 外,Mac 开发环境还需以下工具: