jenv 是 Java 多版本共存最省心的选择，因其在 Shell 层仅通过 shims 符号链接劫持命令、不修改 JAVA_HOME、兼容 IDE/CI、支持项目级 .java-version 绑定且无需依赖特定包管理器。
为什么 jenv 是 Java 多版本共存最省心的选择
因为 Shell 层面的 JAVA_HOME 切换太容易漏配、误配，而 IDE 或构建工具（如 Maven）又常绕过系统环境变量读取自己的 JDK 路径。jenv 不改全局变量，只在 shell 会话或项目目录里做符号链接劫持，对命令行工具、IDE、CI 都透明兼容。
它不安装 JDK，只管理已有的 JDK 实例；不依赖特定包管理器（比如 Homebrew 的 openjdk@17），只要路径里有 bin/java 就能加进来。
- 必须手动把各 JDK 安装路径加入
jenv：比如/Library/Java/JavaVirtualMachines/jdk-8.jdk/Contents/Home、/opt/homebrew/opt/openjdk@21/libexec/openjdk.jdk/Contents/Home -
jenv add后不会自动重命名版本别名，得用jenv version-name自定义，否则默认显示为路径哈希，难识别 - 如果用 zsh，记得在
~/.zshrc末尾加source $(brew --prefix jenv)/libexec/jenv.sh（macOS）或对应路径，否则重启终端就失效
如何让不同项目自动用不同 JDK 版本
jenv 支持项目级 JDK 绑定，靠的是根目录下的 .java-version 文件——不是配置文件，就是一个纯文本，里面只写一行版本标识符，比如 17.0.2 或你自定义的 corretto-11。
这个机制生效的前提是：jenv local <version> 命令已在项目目录执行过，且该目录下生成了 .java-version；它不递归继承，子目录要单独设，除非用 jenv global 设全局兜底。
立即学习“Java免费学习笔记（深入）”；
- IDEA 默认不读
.java-version，需开启 “Use project JDK from .java-version file”（Settings → Build → Gradle → Project SDK） - Maven 本身不感知
jenv，但它的mvn compile会调用java，所以只要which java指向正确版本即可 - 如果
.java-version写了不存在的版本名，java -version会报错，且不 fallback 到 global，直接失败
jenv 和系统 JAVA_HOME 冲突怎么办
jenv 本质是通过 wrapper 脚本控制 java、javac 等命令的执行路径，但它不强制覆盖 JAVA_HOME。很多老项目或脚本硬编码读 JAVA_HOME，这时就得手动同步。
推荐做法是：让 jenv 管理命令，再用 jenv exec 或钩子动态设置 JAVA_HOME，而不是反向用 JAVA_HOME 控制 jenv。
- 执行
jenv enable-plugin export后，每次jenv local/global会自动导出匹配的JAVA_HOME - 某些 CI 环境（如 GitHub Actions）没加载
jenv.sh，java -version显示对了但$JAVA_HOME还是旧值，得显式补一句export JAVA_HOME=$(/usr/libexec/java_home -v$(jenv version-name | cut -d' ' -f1)) - Mac 上
/usr/libexec/java_home只识别 Apple 或 Oracle 官方 JDK，Adoptium / Corretto / Temurin 需手动加到/Library/Java/JavaVirtualMachines/才能被扫到
常见错误：明明 jenv versions 列出了版本，java -version 却不变
最可能的原因是：当前 shell 没启用 jenv 的命令拦截，或者 java 被 alias / function / PATH 前置路径劫持了。
先运行 which java —— 正常应返回类似 /Users/xxx/.jenv/shims/java；如果返回 /usr/bin/java 或其他路径，说明 shims 没生效。
- 检查
echo $PATH是否包含~/.jenv/shims，且位置在系统/usr/bin之前 - 运行
type java，若输出java is aliased to ...或java is a function，就得删掉冲突的 alias/function - VS Code 终端有时缓存旧 PATH，关掉全部窗口重开，或在设置里加
"terminal.integrated.env.osx": {"PATH": "/Users/xxx/.jenv/shims:${env:PATH}"}
版本切换不是魔法，它只是让你的 java 命令软链到不同 JDK 的 bin 目录。哪一步断了，就回溯哪一层 PATH 或 shim 链路。
