mac上java版本切换冲突的核心是java_home、path与工具链（mvn/gradle/ide）实际使用的jdk路径三者不一致；应通过/usr/libexec/java_home -v查可用版本，用export java_home=$(/usr/libexec/java_home -v x)动态设置，并配合path更新或jenv实现项目级隔离。
mac 上多个 java 版本切换冲突，核心不是 jdk 没装全，而是 java_home、path 和工具链（mvn/gradle/ide）实际读取的 jdk 路径三者不一致。比如终端显示 java -version 是 17，但 mvn compile 报错 “invalid target release: 17”，或者 intellij 提示 “cannot resolve symbol”，基本都是环境变量没对齐导致的。
确认已安装哪些 JDK
先看清家底，避免切到不存在的版本：
- 运行 /usr/libexec/java_home -V —— 列出所有被系统识别的 JDK，含版本号和完整路径
- 检查 /Library/Java/JavaVirtualMachines/ 目录，看是否有 .jdk 文件夹（官方包或 Homebrew 安装的都落在这）
- 注意区分：/Library/Internet Plug-Ins/JavaAppletPlugin.plugin/... 是浏览器插件版 Java 8，不能当开发 JDK 用
用 /usr/libexec/java_home 动态设 JAVA_HOME
别硬写死路径（如 /Library/Java/.../jdk-17.jdk/Contents/Home），系统升级或重装后容易失效。正确做法是让系统自动定位：
- 切换到 JDK 17：export JAVA_HOME=$(/usr/libexec/java_home -v 17)
- 切换到 JDK 11：export JAVA_HOME=$(/usr/libexec/java_home -v 11)
- 再补一句：export PATH=$JAVA_HOME/bin:$PATH，确保 java、javac 命令走对的 bin
加别名一键切换（适合日常高频操作）
把上面命令封装成简短别名，写进 ~/.zshrc（Zsh 用户）或 ~/.bash_profile（Bash 用户）：
- alias j8='export JAVA_HOME=$(/usr/libexec/java_home -v 1.8); export PATH=$JAVA_HOME/bin:$PATH; java -version'
- alias j11='export JAVA_HOME=$(/usr/libexec/java_home -v 11); export PATH=$JAVA_HOME/bin:$PATH; java -version'
- alias j17='export JAVA_HOME=$(/usr/libexec/java_home -v 17); export PATH=$JAVA_HOME/bin:$PATH; java -version'
保存后运行 source ~/.zshrc，之后输入 j11 就能立刻切换并验证。
用 jenv 管理多场景需求（推荐长期项目）
如果要按项目绑定 JDK（比如 A 项目固定用 8，B 项目必须用 21），或常在全局/局部/会话间切换，jenv 更省心：
- 安装：brew install jenv
- 添加 JDK：jenv add /Library/Java/JavaVirtualMachines/jdk-1.8.jdk/Contents/Home
- 设全局默认：jenv global 1.8
- 进某个项目目录，设局部版本：jenv local 21（会自动生成 .java-version 文件）
- jenv 会自动接管 JAVA_HOME 和 PATH，Maven、Gradle、IDE 都能感知
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
