Mac系统Java开发，环境配置总结-java教程-PHP中文网

mac java开发环境配置失败的90%问题源于java_home错误、shell配置文件选错（如zsh下误改.bash_profile）或apple silicon使用x86_64 jdk；应改~/.zshrc，用/usr/libexec/java_home -v 21动态获取路径，并确保jdk与maven均为arm64架构。

mac系统java开发，环境配置总结

Mac 上 Java 开发环境配不起来，90% 的问题出在 JAVA_HOME 指向错误、Shell 配置文件选错、或者 Apple Silicon（M 系列芯片）下用了 x86_64 的 JDK。别折腾 .bash_profile 或手动拼路径了——用对工具链，三分钟就能跑通 java -version 和 mvn -v。

为什么 `java -version` 显示旧版本或报 command not found

根本原因不是没装 JDK，而是终端压根没加载到你刚装的那个 JDK。macOS 默认用 zsh（Catalina 及之后），但很多人还在往 .bash_profile 里写配置，结果白写了。

先确认当前 Shell：echo $SHELL —— 如果输出是 /bin/zsh，就该改 ~/.zshrc，不是 .bash_profile
别硬编码路径，用 /usr/libexec/java_home -v 21 查真实路径（把 21 换成你要的版本号），再导出：export JAVA_HOME=$(/usr/libexec/java_home -v 21)
如果 Homebrew 安装的 OpenJDK（比如 openjdk@21），它的 bin 目录默认在 /opt/homebrew/opt/openjdk@21/bin，直接加进 PATH 更稳：export PATH="/opt/homebrew/opt/openjdk@21/bin:$PATH"
source ~/.zshrc 后，立刻验证：which java 应该指向你刚配的路径，$JAVA_HOME 要能 echo 出来

Homebrew 装 JDK 后 `mvn` 报 `illegal instruction`

这是 Apple Silicon 最典型陷阱：M 系列芯片必须用 arm64 架构的 JDK，但某些 Maven 版本（尤其是老版本）或打包脚本仍调用 x86_64 的 JVM 指令，直接崩溃。

OpenJDK 24

下载

检查 JDK 架构：file $(/usr/libexec/java_home)/bin/java —— 输出里要有 arm64，不能是 x86_64
Maven 自带的 mvn 脚本会读 JAVA_HOME，但如果它内部硬编码了 JVM 参数（比如 -XX:MaxPermSize），而新版 JDK 已废弃这些参数，也会崩；删掉 MAVEN_OPTS 环境变量试试
推荐用 SDKMAN 管理 Maven：sdk install maven，它自动适配当前 JDK 架构，比手动下载 zip 包靠谱得多
如果坚持用 Homebrew 装 Maven（brew install maven），确保 JDK 和 Maven 都是 arm64 —— Homebrew 在 M 系列上默认装 arm64，但如果你之前用 Rosetta 装过东西，可能混了架构

多个 JDK 版本共存时，项目用错版本怎么办

全局 JAVA_HOME 只能设一个，但 Spring Boot、Gradle 项目常要求 JDK 17，老系统维护又得切回 JDK 8 —— 手动改配置太容易翻车。

别靠改 ~/.zshrc 切换，用 sdk use java 17.0.2-tem（SDKMAN）或 direnv + .envrc 文件实现目录级自动切换
IntelliJ IDEA 里每个项目可单独指定 Project SDK 和 Language Level，但注意：Terminal 标签页默认继承全局 Shell 环境，不会自动同步 IDE 设置；需在 Settings > Tools > Terminal 里勾选 “Shell integration” 并重启终端
Gradle 项目可通过 gradle.properties 强制指定：org.gradle.java.home=/opt/homebrew/opt/openjdk@17，比依赖环境变量更可靠
Maven 的 pom.xml 中 maven-compiler-plugin 的 source 和 target 只控制编译字节码版本，不决定运行时 JDK —— 运行时还是看 JAVA_HOME 或 mvn 启动时实际加载的 JVM

最易被忽略的点：Xcode Command Line Tools 不装或没授权，brew install 会卡死或报错，连带影响所有后续步骤。执行 xcode-select --install 后，务必再跑一次 sudo xcodebuild -license accept，否则 Homebrew 会拒绝工作。