jenv是macos上通过homebrew实现java多版本一键切换的核心工具，它不替换jdk，仅智能调度path和java_home，支持全局、shell级、项目级三档切换，并需手动添加homebrew安装的openjdk路径（如/opt/homebrew/opt/openjdk@17/libexec）后生效。
在 macOS 上用 Homebrew 实现 Java 版本一键切换，核心不是靠手动改环境变量，而是借助 jenv 这个轻量、稳定、原生适配 shell 的版本管理工具。它不替换 JDK，只调度 PATH 和 JAVA_HOME，和 Homebrew 安装的各版 OpenJDK 配合得天衣无缝。
安装 jenv 并接入 Homebrew
先确保 Homebrew 已就位（Apple Silicon 默认路径为 /opt/homebrew）：
- 运行
brew install jenv - 将 jenv 加入 shell 初始化：在
~/.zshrc末尾添加export PATH="$HOME/.jenv/bin:$PATH"eval "$(/opt/homebrew/bin/brew --prefix jenv)/bin/jenv init -)" - 执行
source ~/.zshrc生效（注意：别只开新终端，Zsh 启动可能读.zprofile，如有冲突需检查）
让 jenv 自动发现 Homebrew 安装的 JDK
Homebrew 安装的 OpenJDK（如 openjdk@17、openjdk@21）默认装在 /opt/homebrew/opt/openjdk@xx/libexec，但 jenv 不会自动识别。需手动添加：
- 运行
jenv add /opt/homebrew/opt/openjdk@17/libexec - 同理添加其他版本：
jenv add /opt/homebrew/opt/openjdk@21/libexec、jenv add /opt/homebrew/opt/openjdk@8/libexec - 执行
jenv versions确认列表里出现类似17.0、21.0的条目（带星号表示已激活）
三档切换：全局、当前 Shell、当前项目目录
jenv 支持不同粒度的版本锁定，避免跨项目干扰：
-
全局生效（所有新终端）：
jenv global 17.0 -
仅当前终端：
jenv shell 21.0（关闭终端即失效） -
项目级绑定：进入工程根目录，运行
jenv local 17.0，会在该目录下生成.java-version文件，下次 cd 进来自动切换
验证与排障要点
切换后务必验证三要素是否同步更新：
-
java -version—— 输出应匹配你设的版本 -
echo $JAVA_HOME—— 应指向 jenv 管理的真实路径，如/Users/xxx/.jenv/versions/17.0 -
which java—— 应为/Users/xxx/.jenv/shims/java，而非/usr/bin/java或 Homebrew 的原始路径 - 若仍指向旧版本，检查是否在
.zprofile或 IDE 终端设置中硬编码了JAVA_HOME，jenv 无法覆盖这类静态赋值
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
