用 jenv 管理 Mac 多 JDK 版本最稳定，因其通过 shell hook 统一代理 java 命令，支持全局（jenv global）和项目级（jenv local）切换，并能被 IntelliJ、Gradle 等工具正确识别，避免 JAVA_HOME 手动配置错误。
Mac 上装多个 JDK 版本不难，但直接改 JAVA_HOME 或手动改 PATH 很容易出错、切换失效、IDE 不识别——用 jenv 是目前最稳的方案。
为什么不用 brew install openjdk@17 就完事？
Homebrew 安装的 OpenJDK 默认装在 /opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk 这类路径，不是标准 JDK 根目录；java -version 能跑，但 IntelliJ、Gradle、Maven 常常找不到 javac 或读不到 tools.jar（虽然 JDK 9+ 已移除）。更关键的是：多个版本共存时，系统无法自动区分哪个是“当前项目该用的”。
实操建议：
- 用
brew install openjdk@11、brew install openjdk@17等命令装好各版本，但别指望它们能直接被java命令调用 - 装完后执行
brew info openjdk@17，抄下libexec后面那段完整路径，这是后续jenv添加版本要用的 - Oracle JDK 或 Temurin 下载的 .dmg 安装包，会把 JDK 放进
/Library/Java/JavaVirtualMachines/，这个路径jenv能直接识别，不用额外处理
安装和初始化 jenv 的三步关键操作
jenv 本身不装 JDK，只做版本注册与环境代理。它通过 shell hook 注入 java、javac 等命令，让所有调用都走它控制的符号链接。
立即学习“Java免费学习笔记（深入）”；
实操建议：
- 先装
jenv：brew install jenv（注意不是brew install jenv/jenv/jenv，旧文档里有误导） - 在
~/.zshrc末尾加两行：export PATH="$HOME/.jenv/bin:$PATH"和eval "$(/opt/homebrew/bin/jenv init -)"（路径按你brew --prefix输出的实际值调整） - 重启终端或执行
source ~/.zshrc，然后运行jenv versions—— 如果报错command not found，说明init没生效，检查是否漏了eval行或 shell 类型不匹配（M1/M2 用 zsh，不是 bash）
怎么把已装的 JDK 加进 jenv 并正确切换？
jenv 不会自动扫描系统 JDK，必须手动添加。添加时路径必须指向 JDK 目录本身，不是 bin 子目录，也不是 .jdk 包裹路径（除非是 macOS 原生格式）。
常见错误现象：
-
jenv add /opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk→ 失败，因为 Homebrew 的 .jdk 是符号链接包裹体，jenv解析失败 -
jenv add /opt/homebrew/opt/openjdk@17/libexec→ 失败，这不是 JDK 根目录
实操建议：
- 对 Homebrew JDK：用
ls -la /opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk查看真实路径（比如指向../../../Cellar/openjdk@17/17.0.2/libexec/openjdk.jdk），然后用那个绝对路径加jenv - 对 Oracle/Temurin：直接加
/Library/Java/JavaVirtualMachines/jdk-17.0.2.jdk这类路径即可 - 加完用
jenv versions确认列表里出现17.0、11.0等标识，再用jenv global 17.0设全局，默认就生效了 - 项目级切换用
jenv local 11.0，会在当前目录生成.java-version文件，比export JAVA_HOME=...可靠得多
IntelliJ / VS Code / Gradle 为啥还是用错 Java 版本？
IDE 和构建工具启动时可能绕过 shell 环境，读取的是自己的启动配置或系统默认 JAVA_HOME，和终端里 jenv 设置的无关。
实操建议：
- IntelliJ：Preference → Build → Gradle → JVM，选 “Project SDK” 或明确指定路径，不要选 “Bundled”
- VS Code：检查
java.home设置，必须指向jenv当前激活的 JDK 路径，可用jenv which java查到真实路径（例如/Users/xxx/.jenv/versions/17.0/bin/java） - Gradle：如果
gradle -v显示的 Java 版本不对，说明它没走 shell 的java命令，而是用了自己硬编码的JAVA_HOME—— 在gradle.properties里删掉org.gradle.java.home配置，或确保它和jenv which java的父目录一致
最容易被忽略的点：每次用 jenv global 或 jenv local 切换后，IDE 必须重启终端式控制台（比如 Terminal 插件），否则里面跑的 gradle 或 mvn 还是旧环境。不是所有工具都会动态 reload jenv 状态。
