使用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环境内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！
相关文章
这篇文章主要介绍了Java的Junit测试框架中的其他注解说明,JUnit是一个开源的java单元测试框架,它是XUnit测试体系架架构的一种体现,2023-10-10
是Java语言事实上的标准单元测试库,需要的朋友可以参考下
这篇文章主要介绍了Spring boot actuator端点启用和暴露操作，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教2021-07-07
本文主要介绍了java对list＜Object＞进行手动分页实现，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2022-07-07
解决Mybatis报错:org.apache.ibatis.reflection.ReflectionException
文章主要讨论了在使用MyBatis进行数据库操作时遇到的几个常见问题及其解决方法,首先,文章指出如果DTO类中没有定义getter和setter方法,会导致反射异常,解决方法是使用Lombok的@Data注解自动生成这些方法2025-01-01
这篇文章主要介绍了Java反转链表测试过程，学习过数据结构的小伙伴们，对链表想来是并不陌生。本篇文章将为大家介绍几种在Java语言当中，实现链表反转的几种方法，以下是具体内容2023-04-04
这篇文章主要介绍了浅谈IDEA中Maven配置问题全解决，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2020-07-07
JSON（JavaScript Object Notation）是数据交换的轻量级格式,它以易于人类阅读和机器解析的方式组织数据,基于键值对,在Java开发中,处理JSON数据通常涉及使用Jackson、Gson、Fastjson等库,本文给大家介绍JSON数据操作与处理全面指南,感兴趣的朋友一起看看吧2024-10-10
下面小编就为大家分享一篇Spring常用注解 使用注解来构造IoC容器的方法，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧2018-01-01
这篇文章主要介绍了Spring中Eureka的自我保护详解,当Eureka Server节点在短时间内丢失过多客户端时(可能发生了网络分区故障),那么这个节点就会进入自我保护模式,一旦进入该模式,Eureka Server就会保护服务注册表中的信息,需要的朋友可以参考下2023-11-11
这篇文章主要介绍了java使用JDBC连接数据库的五种方式(IDEA版),文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2021-04-04
最新评论