在Mac系统中如何配置Java环境_macOS下Java开发环境搭建方法_技术教程

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 命令）：

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 是运行时决定的