Mac上JDK“失效”主因是环境配置未适配系统变化：需选对ARM64/x64安装包、路径不可手动移动、用/usr/libexec/java_home -v 21动态设JAVA_HOME、PATH中$JAVA_HOME/bin须置顶，并新开终端验证java/javac/$JAVA_HOME三者。
Mac 系统上 JDK 安装后“失效”，通常不是没装上，而是环境配置没跟上系统变化或路径逻辑没理清。关键在于：路径固定、变量动态、生效及时、验证到位。下面四步直击核心问题。
选对安装包，避免架构不兼容
Apple Silicon（M1/M2/M3）必须用 ARM64 / aarch64 版本；Intel 芯片只能用 x64 版本。混用会导致 java 命令报错 “Bad CPU type in executable”。
- 从 Oracle 官网或 Eclipse Temurin 下载带
.dmg后缀的安装器（不是 .tar.gz），确保是 LTS 版本（如 JDK 21 或 17） - 下载页明确标注 “macOS ARM64” 或 “macOS x64”，别只看文件名里的 “jdk-21” 就点下载
- 拒绝第三方镜像站，防止静默捆绑软件干扰后续路径识别
安装落地路径不能动
macOS 的 JDK 默认装在系统级目录：/Library/Java/JavaVirtualMachines/jdk-xx.x.x.jdk/Contents/Home。这个路径由安装器写死，手动移动、重命名或剪切到用户目录（如 ~/Downloads）会直接导致 JAVA_HOME 失效。
Java Maven Common
下载
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
- 安装时双击 .pkg 全程点“继续”，无需改路径——它本来就不该改
- 装完可用终端执行
/usr/libexec/java_home -V确认是否出现在列表里，带星号（*）的是当前默认版本 - 如果没出现，说明安装未完成或被安全策略拦截（检查“系统偏好设置 → 隐私与安全性”中是否允许了该安装器）
用 /usr/libexec/java_home 动态设 JAVA_HOME
硬编码路径（如 export JAVA_HOME=/Library/Java/.../Home）极易失效：换 JDK 版本、重装系统、甚至升级 macOS 后路径微调都会崩。正确做法是让系统自动找最新匹配版本。
立即学习“Java免费学习笔记（深入）”；
- 编辑
~/.zshrc（macOS Catalina 及以后默认 shell 是 zsh） - 添加这两行（以 JDK 21 为例）：
export JAVA_HOME=$(/usr/libexec/java_home -v 21)
export PATH=$JAVA_HOME/bin:$PATH -
/usr/libexec/java_home -v 21会实时返回该版本的实际 Home 路径，哪怕你之后装了 JDK 21.0.5 或 21.0.6，也不用手动改配置
验证三要素，缺一不可
只跑 java -version 成功 ≠ 配置完成。很多失效问题出在 javac 找不到，或 IDE 读不到 JAVA_HOME。
-
java -version→ 确认运行时正常 -
javac -version→ 确认编译器可用（二者版本号必须一致） -
echo $JAVA_HOME→ 必须输出完整路径，且结尾是/Home，不是/jdk或空值 - 新开一个终端窗口再验证——旧窗口不会自动加载新配置，
source ~/.zshrc只对当前窗口生效
