Mac装Java环境的关键是选对ARM64/x64版JDK、用/usr/libexec/java_home动态配置JAVA_HOME于~/.zshrc、并通过终端启动IDE或手动绑定SDK路径。
Mac 上装 Java 环境，核心不是“装 JDK”，而是选对版本、配对 JAVA_HOME、避开系统自带的过时 JDK 和 zsh 配置失效问题。
确认当前是否已有 JDK 且是否可用
macOS 自带的 /usr/bin/java 是 Apple 提供的旧版 JDK（如 JDK 6），早已废弃，不能用于现代 Java 开发。必须手动安装新版 JDK。
- 运行
java -version和/usr/libexec/java_home -V查看已注册的 JDK 列表；若只显示1.6.0_65或空输出，说明没装可用 JDK -
which java返回/usr/bin/java是系统 stub，不可靠，别依赖它 - 注意：Apple Silicon（M1/M2/M3）芯片 Mac 必须使用 ARM64 架构的 JDK，x86_64 版本在 Rosetta 下可能出兼容问题
下载并安装 JDK（推荐 Adoptium / Temurin）
Oracle JDK 虽可商用，但需登录下载且许可限制多；Adoptium（Eclipse Temurin）是开源、免费、生产就绪的首选。
- 访问 https://www.php.cn/link/e387385ebe0dbeefed3e8e9f3968aaba，选择最新 LTS 版本（如
21或17），架构选ARM64（M系列芯片）或x64（Intel） - 下载
.pkg安装包，双击安装（默认路径为/Library/Java/JavaVirtualMachines/jdk-21.jdk） - 安装后再次执行
/usr/libexec/java_home -V，应看到类似：/usr/libexec/java_home -V Matching Java Virtual Machines (2): 21.0.1 (arm64) "Eclipse Temurin" - "Temurin 21.0.1" /Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home 17.0.9 (arm64) "Eclipse Temurin" - "Temurin 17.0.9" /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home
正确配置 JAVA_HOME 和 PATH（zsh 用户重点）
Mac 默认 shell 是 zsh，~/.bash_profile 已无效；必须改 ~/.zshrc，且 JAVA_HOME 必须用 /usr/libexec/java_home 动态获取，不能硬编码路径。
立即学习“Java免费学习笔记（深入）”；
- 编辑
~/.zshrc：echo 'export JAVA_HOME=$(/usr/libexec/java_home -v 21)' >> ~/.zshrc echo 'export PATH=$JAVA_HOME/bin:$PATH' >> ~/.zshrc
- 立即生效：
source ~/.zshrc - 验证：
echo $JAVA_HOME应输出完整路径；java -version和javac -version输出一致且匹配你选的版本 - ⚠️ 常见错误：写成
export JAVA_HOME=/Library/Java/.../Home—— 升级 JDK 后路径变更，硬编码会失效
IDE（IntelliJ / VS Code）识别不到 JDK 怎么办
IDE 不读 shell 的 ~/.zshrc，尤其从 Finder 启动时，环境变量为空。这不是 JDK 没装好，而是启动方式问题。
- 终端中启动 IDE 才能继承环境变量：
open -a "IntelliJ IDEA"或code（前提是 VS Code CLI 已安装） - IntelliJ：进入
Project Structure → Project → Project SDK，点击New → JDK，手动定位到/Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home - VS Code：安装 Extension Pack for Java，按提示重启后，项目根目录下建
.vscode/settings.json指定："java.configuration.runtimes": [ { "name": "JavaSE-21", "path": "/Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home" } ]
最易被忽略的是 shell 配置与 GUI 应用的环境隔离——哪怕 java -version 在终端里完全正确，IDE 仍可能报“no JDK found”，这时候别重装 JDK，先检查启动方式和 IDE 的 SDK 手动绑定。
