本文详细指导在 apple silicon（m1/m2/m3）mac 上手动安装 java 19 jdk 的完整流程，涵盖官方下载渠道、校验方法、安装路径配置及与 gradle 等构建工具的兼容性设置。
本文详细指导在 apple silicon（m1/m2/m3）mac 上手动安装 java 19 jdk 的完整流程，涵盖官方下载渠道、校验方法、安装路径配置及与 gradle 等构建工具的兼容性设置。
Apple Silicon Mac 用户若需使用 Java 19（例如因 Gradle 构建脚本明确要求 JDK 19，而当前 Homebrew 默认仅提供 openjdk（最新版，如 JDK 20）和 openjdk@17），需绕过 Homebrew 的版本限制，通过官方渠道获取并手动安装 JDK 19。
✅ 正确下载 Java 19（ARM64 版本）
Homebrew 已移除对 openjdk@19 的独立公式支持（自 2023 年起），因此不能依赖 brew install openjdk@19。推荐使用以下两个权威来源之一：
JDK.net（OpenJDK 官方预发布/归档站）：
访问 https://www.php.cn/link/5f928b9ebcca59928543c3484adc86ad → 下载 jdk-19.0.2_macos-aarch64_bin.tar.gz（注意后缀含 aarch64，即 Apple Silicon 原生 ARM64 架构）。
✅ 免费、开源、无 Oracle 账户要求。Oracle JDK 归档页（含长期支持版本）：
访问 https://www.php.cn/link/350beead34794a68531b542b84a99e4b → 找到 JDK 19.0.2 → 选择 macOS AArch64 版本。
⚠️ 需 Oracle 账户登录下载，但提供商业级支持与更严格的 QA 测试。
? 提示：所有 JDK 19 发行版均提供 脚本友好型 URL 和 SHA256 校验码，便于自动化部署与完整性验证。例如：
curl -O https://download.oracle.com/java/19/latest/jdk-19.0.2_macos-aarch64_bin.tar.gz echo "d4e...8a3 jdk-19.0.2_macos-aarch64_bin.tar.gz" | sha256sum -c -
? 手动安装至标准 JVM 路径
解压后，将 JDK 移动至 macOS 的标准 JVM 目录，并确保权限正确：
立即学习“Java免费学习笔记（深入）”；
# 解压（假设下载到 ~/Downloads） tar -xzf ~/Downloads/jdk-19.0.2_macos-aarch64_bin.tar.gz # 移动到系统 JVM 目录（需管理员权限） sudo mv jdk-19.0.2.jdk /Library/Java/JavaVirtualMachines/ # 验证安装 /usr/libexec/java_home -V # 输出中应包含类似： # 19.0.2 (arm64) /Library/Java/JavaVirtualMachines/jdk-19.0.2.jdk/Contents/Home
? 配置开发环境（Gradle / IDE / Shell）
安装完成后，需显式指定 JDK 19 使用：
-
终端临时切换：
export JAVA_HOME=$(/usr/libexec/java_home -v 19) java -version # 应显示 "java version "19.0.2""
-
永久生效（推荐）：
在 ~/.zshrc 或 ~/.bash_profile 中添加：export JAVA_HOME=$(/usr/libexec/java_home -v 19)
-
Gradle 构建：
确保 gradle.properties 或项目 gradle/wrapper/gradle-wrapper.properties 中未硬编码 JDK 路径；Gradle 会自动读取 JAVA_HOME。也可在 gradlew 启动时强制指定：JAVA_HOME=$(/usr/libexec/java_home -v 19) ./gradlew build
IntelliJ IDEA / VS Code：
在项目设置中将 Project SDK 指向 /Library/Java/JavaVirtualMachines/jdk-19.0.2.jdk/Contents/Home。
⚠️ 注意事项与常见问题
- ❌ 不要使用 brew reinstall openjdk —— 这只会重装最新版（JDK 20+），无法降级。
- ✅ JDK 19 是非LTS 版本（2022.9 发布，2023.10 结束免费更新），生产环境建议搭配 JDK 17（LTS）或 JDK 21（LTS）评估升级路径。
- ? 若使用 Oracle JDK，请留意其 许可协议变更，个人开发通常免费，企业部署需确认合规性。
- ? 安装后若 java -version 仍显示旧版本，请检查 which java 及 echo $JAVA_HOME，避免 shell 缓存或 IDE 缓存导致误判。
完成以上步骤，即可在 Apple Silicon Mac 上稳定运行 Java 19，并顺利构建依赖该版本的 Gradle 项目。
