使用 jEnv 管理多个 JDK 安装 | Baeldung

1. 引言

随着 Java 版本更新频率加快，我们经常需要在同一环境中管理多个并行的 JDK 版本。手动维护 JAVA_HOME 环境变量很快就会变成一场噩梦。

本文将介绍 jEnv 如何优雅地解决多 JDK 管理问题，让你在不同项目间无缝切换 Java 版本。

2. 什么是 jEnv？

jEnv 是一个命令行工具，专门用于管理多个 JDK 安装。它能智能地在 shell 中设置 JAVA_HOME，支持三种作用域：

✅ 全局（整个系统）
✅ 本地（当前目录）
✅ Shell（当前会话）

核心优势：快速切换 Java 版本，特别适合同时维护多个使用不同 Java 版本的项目。

⚠️ 重要提醒：jEnv 不负责安装 JDK，它只是帮你管理已安装的 JDK 版本。

3. 安装 jEnv

jEnv 支持 Linux/macOS 和 Bash/Zsh shell。安装过程简单直接：

macOS 安装（推荐 Homebrew）

$ brew install jenv

Linux 安装（源码方式）

$ git clone https://github.com/jenv/jenv.git ~/.jenv

配置环境变量

根据你的 shell 类型选择对应配置：

Bash 用户：

$ echo 'export PATH="$HOME/.jenv/bin:$PATH"' >> ~/.bash_profile
$ echo 'eval "$(jenv init -)"' >> ~/.bash_profile

Zsh 用户：

$ echo 'export PATH="$HOME/.jenv/bin:$PATH"' >> ~/.zshrc
$ echo 'eval "$(jenv init -)"' >> ~/.zshrc

验证安装

使用 jenv doctor 检查安装状态（macOS 示例）：

$ 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.
    PATH : /opt/homebrew/Cellar/jenv/0.5.4/libexec/libexec:/Users/jenv/.jenv/shims:/Users/user/.jenv/bin:/opt/homebrew/bin:/opt/homebrew/sbin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin
[OK]    Jenv is correctly loaded

输出显示 jEnv 已正确加载，但尚未配置 JDK。

4. 管理 JDK 安装

4.1. 添加 JDK 到 jEnv

关键特性：jEnv 不限制 JDK 安装方式，无论是通过包管理器（brew/yum/apt）还是手动下载安装，都能轻松管理。

添加 JDK 的命令格式：

$ jenv add /JDK安装路径

示例：添加 JDK 8

$ jenv add /Library/Java/JavaVirtualMachines/openjdk-8.jdk/Contents/Home/
openjdk8-1.8.0.332 added
1.8.0.332 added
1.8 added

验证配置：

$ jenv doctor
[OK]    No JAVA_HOME set
[OK]    Java binaries in path are jenv shims
[OK]    Jenv is correctly loaded

查看已注册 JDK：

$ jenv versions
* system (set by /Users/user/.jenv/version)
  1.8
  1.8.0.332
  openjdk64-1.8.0.332

多 JDK 示例：添加 JDK 11

$ jenv add /Library/Java/JavaVirtualMachines/openjdk-11.jdk/Contents/Home/
openjdk64-11.0.15 added
11.0.15 added
11.0 added
11 added

最终版本列表：

$ jenv versions
* system (set by /Users/avinb/.jenv/version)
  1.8
  1.8.0.332
  11
  11.0
  11.0.15
  openjdk64-11.0.15
  openjdk64-1.8.0.332

4.2. 使用 jEnv 管理 JDK 版本

jEnv 提供三级版本控制：

作用域	命令	说明
全局	`jenv global`	系统默认版本
本地	`jenv local`	当前目录专用版本
Shell	`jenv shell`	当前会话临时版本

全局版本管理：

$ jenv global 11
$ jenv global
11

本地版本管理（项目级）：

$ cd ~/baeldung-project
$ jenv local
jenv: no local version configured for this directory

设置本地版本：

$ jenv local 1.8

这会在当前目录创建 .java-version 文件，内容为 1.8。验证：

$ jenv local
1.8

Shell 级别版本（临时生效）：

$ jenv shell 1.8

此设置会覆盖全局和本地版本，仅对当前 shell 有效。

4.3. 配置 Maven/Gradle 集成

默认情况下，Maven/Gradle 使用系统 JDK 而非 jEnv 管理的版本。需要启用插件：

Maven 插件：

$ jenv enable-plugin maven

Gradle 插件：

$ jenv enable-plugin gradle

⚠️ 踩坑提示：若遇到版本不生效问题，启用 export 插件：

$ jenv enable-plugin export

此插件确保 JAVA_HOME 变量正确设置。

💡 替代方案：SDKMAN 也是优秀的多版本管理工具。

5. 总结

本文系统介绍了 jEnv 的核心功能：

安装配置：支持主流操作系统和 shell
JDK 管理：灵活添加/切换多个 JDK 版本
三级版本控制：全局/本地/Shell 精准控制
构建工具集成：无缝支持 Maven/Gradle

对于需要同时维护多个 Java 版本项目的开发者，jEnv 是简单粗暴的解决方案。通过智能的 JAVA_HOME 管理，彻底告别环境变量混乱问题。

✅ 最佳实践：结合本地版本控制（.java-version 文件）和全局默认版本，实现项目级版本隔离。

Persistence

REST

Security