Mac配置Java环境需正确设置JAVA_HOME、确保java/javac可用、与IDE兼容；推荐安装Eclipse Temurin JDK 21，用/usr/libexec/java_home -v 21动态配置，并在IDE中手动指定SDK路径。
Mac 上配置 Java 开发环境，核心不是“装 JDK 就完事”，而是要确认 JAVA_HOME 正确指向、java 和 javac 命令可用、且与你选用的 IDE（如 IntelliJ 或 VS Code）不冲突。多数问题出在路径没设对，或多个 JDK 版本共存时 shell 没加载到预期版本。
如何验证当前是否已安装 JDK 及版本
终端执行以下命令，看是否有输出：
java -version javac -version
如果提示 command not found，说明系统未识别 JDK；如果输出版本但不是你期望的（比如显示 17.0.1 而你想要 21），说明存在多版本，需手动切换。注意：macOS 自带的 /usr/bin/java 是 Apple 提供的旧版封装，不可用于开发，必须用 Oracle、Eclipse Temurin 或 Azul 等正式发行版。
下载并安装 JDK（推荐 Eclipse Temurin）
避免使用 Oracle JDK 的许可限制和更新跳转问题。直接访问 https://www.php.cn/link/e387385ebe0dbeefed3e8e9f3968aaba，下载 Temurin JDK 21（LTS）的 .pkg 安装包。安装后 JDK 默认路径为：
立即学习“Java免费学习笔记（深入）”；
在调试 Java 后端 API 故障时使用此技能，尤其适用于以下任务：分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转，以及生成简洁的诊断结论与修复方案。
/Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home
该路径就是后续设置 JAVA_HOME 的目标值。安装完成后仍需手动配置环境变量，因为 macOS 不会自动写入 ~/.zshrc 或 ~/.zprofile。
正确设置 JAVA_HOME 和 PATH（Zsh 用户）
macOS Catalina 及之后默认用 Zsh，所以应编辑 ~/.zshrc（或更推荐 ~/.zprofile，它在登录 shell 中更可靠）。添加以下两行：
export JAVA_HOME=$(/usr/libexec/java_home -v 21) export PATH=$JAVA_HOME/bin:$PATH
关键点：
-
/usr/libexec/java_home -v 21是 macOS 内置工具，能动态查到已安装的 JDK 21 路径，比硬编码路径更安全 - 不要用
source ~/.zshrc后就以为生效——新开一个终端窗口才能加载完整环境 - 若同时装了 JDK 17 和 21，
-v 21确保选中的是 21；换成-v 17可临时切回 - VS Code 终端可能不读
~/.zshrc，需在设置中启用"terminal.integrated.env.osx": {"JAVA_HOME": "/path/to/jdk"}
IDE 中常见 Java 相关报错及应对
IntelliJ 启动项目时报 Cannot resolve symbol 'String'，或 Maven 编译提示 Unsupported class file major version 65，本质都是 JDK 版本错配：
- 检查项目 SDK：File → Project Structure → Project → Project SDK → 点击
New… → JDK，选择/Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home - Maven 的
java.version和maven.compiler.source/target需匹配 JDK 版本，例如 JDK 21 对应21，不是1.21或21.0 - Gradle 项目需确认
gradle.properties中org.gradle.java.home指向正确 JDK 路径，否则 CLI 运行和 IDE 运行行为可能不一致
最易被忽略的是：即使终端里 java -version 显示正确，IDE 底层可能仍用自己缓存的旧 JDK 路径，务必进设置里手动指定一次，别依赖自动探测。
