Mac配置Java环境的关键是明确版本、管理方式及JAVA_HOME是否生效，需分别验证终端、IDE和构建工具的JDK一致性，避免因路径混乱导致编译失败或版本不一致。
Mac 上配置 Java 环境的关键不是“装 JDK 就完事”，而是明确你要用哪个版本、由谁来管理、以及 JAVA_HOME 是否真正生效——很多编译失败、IDE 找不到 JDK、java -version 和 javac -version 显示不一致的问题，都源于这里。
确认当前 Java 安装状态与系统默认行为
macOS 自 macOS 10.15（Catalina）起不再预装 JDK，但可能残留旧版或通过 Homebrew / SDKMAN 安装过。先查清现状：
-
which java和which javac查命令路径，注意它们是否指向同一位置 -
/usr/libexec/java_home -V列出所有已注册的 JDK（这是 macOS 官方机制，比ls /Library/Java/JavaVirtualMachines/更可靠） -
java -version和javac -version必须输出相同版本号；若不一致，说明 shell 找到了不同 JDK 的java和javac，JAVA_HOME未生效或被覆盖
用 homebrew 安装并切换 JDK 版本（推荐日常开发）
Homebrew 提供统一安装入口，且支持多版本共存和快速切换，比手动下载 .dmg 更可控。前提是已安装 brew：
brew tap homebrew/cask-versions brew install --cask temurin17 # 或 temurin11、temurin21 /usr/libexec/java_home -V # 确认新 JDK 已注册
设置默认版本（影响 java、javac 命令）：
立即学习“Java免费学习笔记（深入）”；
export JAVA_HOME=$(/usr/libexec/java_home -v 17) # 加入 ~/.zshrc（macOS Catalina 及以后默认 shell 是 zsh）
注意：/usr/libexec/java_home -v 17 返回的是完整路径（如 /opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk/Contents/Home），不是软链接路径；若用 brew install openjdk@17（非 cask），路径会不同，需核对。
JAVA_HOME 在终端和 GUI 应用中是否一致？
在终端里 echo $JAVA_HOME 正确 ≠ IntelliJ / VS Code / Eclipse 能读到它。GUI 应用启动时不加载 ~/.zshrc，所以：
- IntelliJ：Preferences → Build → Gradle → JVM → 选 “Project SDK” 或指定路径，不要依赖环境变量
- VS Code + Extension Pack for Java：在
settings.json中显式设置"java.configuration.runtimes" - 终端新窗口必须
source ~/.zshrc或重启才能生效；可用printenv JAVA_HOME验证
如果坚持让 GUI 应用也读取 JAVA_HOME，需在 ~/.zprofile 中设置（macOS 会为 GUI 进程加载该文件），但不如 IDE 内显式配置可靠。
Gradle / Maven 构建时 JDK 版本不匹配怎么办
即使终端 java -version 正确，Gradle 可能仍用错 JDK，尤其当你用 gradlew（包装器）时：
- 检查
gradle.properties是否设置了org.gradle.java.home，它会覆盖JAVA_HOME - Maven 的
MAVEN_OPTS或~/.mavenrc中若有-Djava.home=...，也会强制覆盖 - Gradle 项目级配置：在
gradle/wrapper/gradle-wrapper.properties里改distributionUrl并不能换 JDK，只换 Gradle 自身版本；JDK 是运行时决定的
最稳妥方式：在项目根目录运行 export JAVA_HOME=$(/usr/libexec/java_home -v 17) && ./gradlew build，或把该行写进 ./gradlew 脚本头部（不推荐长期修改 wrapper）。
真正麻烦的从来不是装 JDK，而是多个工具链（shell、IDE、构建工具、CI 脚本）各自找 JDK 的逻辑不统一；别迷信“一次配置全局生效”，按场景分别确认更省时间。
