使用Jenv管理多版本JDK环境的详细教程
1. 前言
在现代 Java 开发中，我们经常需要在不同的项目中使用不同版本的 JDK。比如：
- 老项目需要使用 JDK 8
- 新项目可能使用 JDK 11 或 JDK 17
- 某些特定框架对 JDK 版本有严格要求
手动切换 JAVA_HOME 环境变量既繁琐又容易出错。Jenv 是一个优秀的 JDK 版本管理工具，可以让我们轻松地在不同 JDK 版本间切换。
2. 什么是 Jenv
Jenv 是一个命令行工具，用于管理多个 Java 版本。它类似于 Node.js 的 nvm 或 Ruby 的 rbenv，可以：
- 全局设置默认 JDK 版本
- 为特定 shell 会话设置 JDK 版本
- 为特定项目目录设置 JDK 版本
官方 GitHub 地址：https://github.com/jenv/jenv
3. 安装 Jenv
3.1 使用 Homebrew 安装
brew install jenv
3.2 配置 Shell 环境
安装完成后需要配置你的 shell 环境：
对于 Zsh 用户：
echo 'export PATH="$HOME/.jenv/bin:$PATH"' >> ~/.zshrc echo 'eval "$(jenv init -)"' >> ~/.zshrc source ~/.zshrc
对于 Bash 用户：
echo 'export PATH="$HOME/.jenv/bin:$PATH"' >> ~/.bash_profile echo 'eval "$(jenv init -)"' >> ~/.bash_profile source ~/.bash_profile
4. 验证安装
安装完成后，可以运行以下命令检查 jenv 状态：
jenv doctor
初次安装可能会看到一些错误信息，这是正常的，我们接下来会逐步配置：
[OK] No JAVA_HOME set [ERROR] Java binary in path is not in the jenv shims. [ERROR] Please check your path, or try using /path/to/java/home is not a valid path to java installation.
5. 查看系统中的 JDK 安装
在添加 JDK 到 jenv 之前，我们需要知道系统中都安装了哪些版本的 JDK：
/usr/libexec/java_home -V
这个命令会列出所有已安装的 JDK 版本及其安装路径：
6. 添加 JDK 版本到 Jenv
6.1 添加单个 JDK 版本
使用 jenv add 命令添加 JDK 版本：
# 语法：jenv add {JDK安装目录}
jenv add /Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home
添加成功后会显示：
zulu64-17.0.15 added 17.0.15 added 17.0 added 17 added
6.2 批量添加多个 JDK 版本
你可以逐个添加所有已安装的 JDK 版本：
# 添加 JDK 8 jenv add /Library/Java/JavaVirtualMachines/zulu8.jdk/Contents/Home # 添加 JDK 11 jenv add /Library/Java/JavaVirtualMachines/jdk-11.jdk/Contents/Home # 添加 JDK 17 jenv add /Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home
7. Jenv 基本使用
7.1 查看已管理的 JDK 版本
jenv versions
输出示例（带 * 号的是当前使用的版本）：
* system (set by /Users/username/.jenv/version) 1.8 1.8.0.452 11 11.0 11.0.26 17 17.0 17.0.15 oracle64-11.0.26 zulu64-1.8.0.452 zulu64-17.0.15
7.2 设置全局默认 JDK 版本
# 设置 JDK 17 为全局默认版本 jenv global 17 # 验证 java -version
输出：
openjdk version "17.0.15" 2025-04-15 LTS OpenJDK Runtime Environment Zulu17.58+21-CA (build 17.0.15+6-LTS) OpenJDK 64-Bit Server VM Zulu17.58+21-CA (build 17.0.15+6-LTS, mixed mode, sharing)
7.3 设置当前 Shell 会话的 JDK 版本
# 在当前 shell 会话中临时使用 JDK 8 jenv shell 1.8 # 验证 java -version
输出：
openjdk version "1.8.0_452" OpenJDK Runtime Environment (Zulu 8.86.0.25-CA-macos-aarch64) (build 1.8.0_452-b09) OpenJDK 64-Bit Server VM (Zulu 8.86.0.25-CA-macos-aarch64) (build 25.452-b09, mixed mode)
7.4 设置项目目录的 JDK 版本
# 进入项目目录 cd /path/to/your/project # 设置该项目使用 JDK 11 jenv local 11 # 验证 java -version
这会在项目根目录下创建一个 .java-version 文件，每次进入该目录时会自动切换到指定的 JDK 版本。
8. 解决 JAVA_HOME 冲突问题
8.1 常见问题
如果你发现切换 JDK 版本后 java -version 没有变化，很可能是因为之前手动设置的 JAVA_HOME 环境变量覆盖了 jenv 的设置。
8.2 解决方案
8.2.1 注释掉手动的 JAVA_HOME 设置
编辑你的 shell 配置文件（如 ~/.zshrc），注释掉之前的 JAVA_HOME 设置：
# JDK Config (注释掉，改用jenv管理) # JAVA_HOME_11=/Library/Java/JavaVirtualMachines/jdk-11.jdk/Contents/Home # JAVA_HOME_8=/Users/username/Library/Java/JavaVirtualMachines/azul-1.8.0_452/Contents/Home # JAVA_HOME_17=/Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home # export JAVA_HOME=$JAVA_HOME_8 # CLASS_PATH="$JAVA_HOME/lib" # PATH="$PATH:$JAVA_HOME/bin" # jenv配置 export PATH="$HOME/.jenv/bin:$PATH" eval "$(jenv init -)"
8.2.2 启用 jenv 的 export 插件
让 jenv 自动管理 JAVA_HOME 环境变量：
jenv enable-plugin export
8.2.3 重新加载 shell 配置
source ~/.zshrc # 或 source ~/.bash_profile
9. 实用技巧
9.1 查看当前 JDK 版本
jenv version
9.2 删除不需要的 JDK 版本
jenv remove 1.8.0.452
9.3 查看 jenv 帮助
jenv --help
9.4 项目级别版本管理
在项目根目录创建 .java-version 文件，内容为 JDK 版本号：
echo "11" > .java-version
这样每次进入该目录时，jenv 会自动切换到指定版本。
10. 最佳实践
- 全局设置 LTS 版本：建议将最新的 LTS 版本（如 JDK 17）设置为全局默认版本
- 项目级别管理：为每个项目设置合适的 JDK 版本，并提交
.java-version文件到版本控制 - 定期清理：删除不再使用的 JDK 版本，保持环境整洁
- 团队协作：团队成员使用相同的
.java-version文件，确保开发环境一致
11. 常见问题
Q1: 为什么切换版本后 java -version 没有变化？
A: 检查是否有手动设置的 JAVA_HOME 环境变量，需要注释掉并启用 jenv 的 export 插件。
Q2: 如何彻底卸载 jenv？
A: 删除 ~/.jenv 目录，并从 shell 配置文件中移除相关配置。
Q3: jenv 和 SDKMAN 哪个更好？
A: 两者各有优势，jenv 专注于 Java 版本管理，SDKMAN 支持更多 JVM 相关工具。选择取决于个人需求。
12. 总结
Jenv 是一个轻量级且强大的 JDK 版本管理工具，能够有效解决多版本 JDK 共存和切换的问题。通过合理使用 jenv 的全局、shell 和本地版本设置功能，我们可以为不同的项目灵活配置所需的 JDK 版本，大大提升开发效率。
记住核心命令：
jenv global <version>- 设置全局版本jenv local <version>- 设置项目版本jenv shell <version>- 设置会话版本jenv versions- 查看所有版本
掌握了这些基本用法，你就能轻松应对多版本 JDK 的管理需求了。
到此这篇关于使用Jenv管理多版本JDK环境的详细教程的文章就介绍到这了,更多相关Jenv管理多版本JDK环境内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！
相关文章
String对象作为Java语言中重要的数据类型之一，是我们平时编码最常用的对象之一，因此也是内存中占据空间最大的一个对象，然而很多人对它是一知半解，今天我们就来好好聊一聊这个既熟悉又陌生的String,需要的朋友可以参考下2023-05-05
SpringMVC @RequestBody Date类型的Json转换方式
这篇文章主要介绍了SpringMVC @RequestBody Date类型的Json转换方式，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教2021-10-10
今天给大家带来的是关于Java的相关知识,文章围绕着Java节点流与字符流展开,文中有非常详细的介绍及代码示例,需要的朋友可以参考下2021-06-06
Spring框架与MyBatis框架是Java互联网技术的主流框架。那么mybatis如何无缝对接spring呢？下面通过本文给大家介绍，需要的的朋友参考下吧2017-09-09
简单聊一聊Java线程池ThreadPoolExecutor
在使用线程池之后,开启线程就变成了在线程池当中找到一个空闲的线程,销毁线程变成了归还线程到线程池的过程,下面这篇文章主要给大家介绍了关于Java线程池ThreadPoolExecutor的相关资料,需要的朋友可以参考下2022-06-06
jps是Java开发者和系统管理员的得力助手,它简化了Java进程监控的过程,使得快速检查应用运行状态变得轻而易举,在Java开发和运维场景中,jps是一个非常实用的命令行工具,本文介绍了如何有效地使用 jps命令来查看Java进程的详细指南,需要的朋友可以参考下2024-10-10
这篇文章主要为大家介绍了spring boot集成redisson的最佳实践示例，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪2022-03-03
这篇文章主要介绍了Java编程Commons lang组件的相关内容，十分具有参考意义,需要的朋友可以了解下。2017-09-09
这篇文章主要介绍了Java9垃圾回收方法finalize() 原理解析,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下2020-02-02
这篇文章主要为大家详细介绍了Java图片上传实现代码，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2016-05-05
最新评论