Mac上Java版本冲突的本质是JAVA_HOME、PATH和Maven/IDE实际读取的JDK路径三者不一致，导致java -version与mvn compile或IDE编译结果不匹配。
Mac上Java版本冲突的本质，是JAVA_HOME、PATH和Maven/IDE实际读取的JDK路径三者不一致。你运行java -version看到的是17，但mvn compile报错“javac: 无效的目标版本: 17”，或者IntelliJ显示“Cannot resolve symbol”——这几乎100%不是Java没装好，而是环境变量没对齐。
为什么java -version和mvn -version显示不同版本？
这是Mac Java环境最典型的“表里不一”现象：
-
java命令走的是/usr/bin/java（系统软链），它会根据/usr/libexec/java_home的当前策略选版本； -
mvn默认读$JAVA_HOME，如果没设或设错，它可能 fallback 到/System/Library/Java/JavaVirtualMachines/1.6.0.jdk这种已弃用路径； - IDE（如IntelliJ）通常忽略
PATH，只认JAVA_HOME或项目级JDK配置，且缓存顽固——改完环境变量后不重启IDE，它还在用旧JDK。
用/usr/libexec/java_home动态定位，别硬写路径
Mac系统自带的/usr/libexec/java_home是唯一可靠的方式，它按系统偏好设置（Java Preferences.app）或-v参数精准返回JDK真实路径。硬编码路径（比如/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home）在重装、升级、Apple Silicon适配时极易失效。
正确做法：
立即学习“Java免费学习笔记（深入）”；
export JAVA_HOME=$(/usr/libexec/java_home -v 17) export PATH=$JAVA_HOME/bin:$PATH
如果你要切到Java 8（例如老项目必须）：
你是 TypeScript 项目架构专家，专注于脚手架搭建生产就绪的 Node.js 和前端应用。生成包含现代工具链（pnpm、Vite、Next.js）、类型
export JAVA_HOME=$(/usr/libexec/java_home -v 1.8) export PATH=$JAVA_HOME/bin:$PATH
验证是否生效：
-
echo $JAVA_HOME→ 应输出类似/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home -
which java→ 应指向$JAVA_HOME/bin/java -
mvn -version→Java version字段必须和java -version一致
多个JDK共存时，别碰/System/Library/Frameworks/JavaVM.framework/Versions/CurrentJDK
早期教程教人用sudo ln -s ... CurrentJDK强行改系统软链，这在macOS Catalina之后已被禁止（SIP保护），且极危险：一旦指向错误路径，连系统更新工具都可能崩溃。
安全替代方案只有两个：
- 用
/usr/libexec/java_home -V列出所有可用JDK，确认目标版本存在； - 通过shell函数快速切换（推荐写进
~/.zshrc）：
java17() {
export JAVA_HOME=$(/usr/libexec/java_home -v 17)
export PATH=$JAVA_HOME/bin:$PATH
echo "✅ Java 17 active"
}
java21() {
export JAVA_HOME=$(/usr/libexec/java_home -v 21)
export PATH=$JAVA_HOME/bin:$PATH
echo "✅ Java 21 active"
}
执行java17即可即时切换，无需重启终端（但已打开的IDE仍需重启）。
IDE和构建工具的“缓存陷阱”最容易被忽略
改完.zshrc并source后，你以为万事大吉？其实：
- IntelliJ IDEA：必须
File → Project Structure → Project SDK手动选新JDK，否则它继续用上次缓存的； - Maven：
~/.m2/settings.xml里若配置了<toolchains></toolchains>，会覆盖JAVA_HOME，务必检查； - VS Code + Extension Pack for Java：需要重启Java Language Server（Cmd+Shift+P → “Java: Restart Language Server”）；
- Gradle：
gradle -version显示的Java版本 ≠ 当前project编译用的JDK，要看gradle.properties里的org.gradle.java.home。
最稳妥的验证方式：在项目根目录下运行./gradlew --version或mvn -X compile 2>&1 | grep 'Java home'，直接看构建工具自己报出的java.home路径。
