macOS上Java开发环境需确保终端、Maven/Gradle和IDE统一识别同一JDK；关键步骤包括：用/usr/libexec/java_home -V确认ARM64/x64架构匹配，动态设置JAVA_HOME并更新PATH，IDE需手动指定JDK路径（如/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home），推荐SDKMAN管理多版本。
在 macos 上跑 java 项目，关键不是装完 jdk 就完事，而是让终端、构建工具（如 maven/gradle）和 ide 都能一致识别同一个 jdk。常见问题比如 javac: command not found、ide 报 “no sdk”，或 maven 编译失败，大多出在环境变量没对齐、路径写死、或启动方式绕过 shell 配置。
确认系统与 JDK 版本匹配
macOS 13（Ventura）及以上版本不再支持 JDK 8；JDK 11 是最低门槛，推荐使用官方长期支持版——JDK 17 或 JDK 21。打开终端执行：
-
sw_vers查看当前系统版本 -
/usr/libexec/java_home -V列出已安装的 JDK 及其架构（注意区分 ARM64 和 x64） - 前往 Eclipse Temurin 或 Azul Zulu 下载对应芯片架构的 .dmg 安装包
配置 JAVA_HOME 并生效到所有终端会话
macOS 不自动设 JAVA_HOME，必须手动声明，且不能硬编码路径——否则换 JDK 就得改配置。推荐用系统内置命令动态获取：
- 编辑 shell 配置文件：
nano ~/.zshrc（M1/M2/M3/M4 Mac 默认用 zsh） - 添加两行（以 JDK 17 为例）：
export JAVA_HOME=$(/usr/libexec/java_home -v 17)export PATH=$JAVA_HOME/bin:$PATH - 保存后执行
source ~/.zshrc - 验证三者输出一致：
java -versionjavac -versionecho $JAVA_HOME
让 IDE 正确识别 JDK
IntelliJ IDEA、VS Code 等工具常通过 Dock、Spotlight 或快捷方式启动，这类方式不加载 ~/.zshrc，所以即使终端里一切正常，IDE 仍可能找不到 JDK。
-
IntelliJ IDEA：Preferences → Project → Project SDK → 点 “+” → Add JDK → 手动选择路径，例如：
/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home - VS Code + Java Extension Pack：Cmd+Shift+P → “Java: Configure Java Runtime” → 在 “Java Configuration Runtimes” 下点击 “Add Runtime” → 浏览并选中同上路径
- 若用 Homebrew 安装（如
brew install openjdk@17），路径通常是：/opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk/Contents/Home
可选：用 SDKMAN 管理多 JDK 版本
如果你要同时维护多个 Java 项目（比如一个用 JDK 8，一个用 JDK 21），手动改 ~/.zshrc 很麻烦。SDKMAN 提供命令级切换：
立即学习“Java免费学习笔记（深入）”；
- 安装：
curl -s "https://get.sdkman.io" | bash，然后重启终端或运行source "$HOME/.sdkman/bin/sdkman-init.sh" - 列出可用 JDK：
sdk list java - 安装并默认使用 JDK 21：
sdk install java 21.0.2-tem→sdk default java 21.0.2-tem - 项目内临时切换：
sdk use java 17.0.1-tem
不复杂但容易忽略：每次换 JDK 后，记得检查 Maven/Gradle 的 Java 版本兼容性，尤其是老项目依赖特定字节码版本时。
