Skip to content

jenv 教程

什么是 jenv

jenv 是一个跨平台的 Java 版本管理工具,它允许你在同一台机器上安装和管理多个 Java 版本,而不会相互干扰。jenv 可以:

  • 管理多个 Java 版本
  • 在不同版本间快速切换
  • 为不同项目设置特定的 Java 版本
  • 自动配置 JAVA_HOME 环境变量

安装 jenv

macOS 安装

使用 Homebrew 安装:

bash
brew install jenv

Linux 安装

使用 Git 克隆并安装:

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

Windows 安装

Windows 用户可以使用 jabbascoop 来管理 Java 版本,或者使用 WSL 来运行 jenv。

环境配置

配置环境变量

macOS/Linux

将以下内容添加到 ~/.bashrc~/.zshrc 文件中:

bash
export PATH="$HOME/.jenv/bin:$PATH"
eval "$(jenv init -)"

然后执行:

bash
source ~/.bashrc  # 或 source ~/.zshrc

基本使用

查看已安装的 Java 版本

bash
jenv versions

查看当前使用的 Java 版本

bash
jenv version

添加已安装的 Java 版本

首先,你需要先安装 Java 版本,然后使用 jenv 添加:

bash
# 示例:添加 Java 11
jenv add /Library/Java/JavaVirtualMachines/openjdk-11.jdk/Contents/Home

# 示例:添加 Java 8
jenv add /Library/Java/JavaVirtualMachines/jdk1.8.0_291.jdk/Contents/Home

设置全局 Java 版本

bash
jenv global 11.0.12

设置局部 Java 版本(当前目录)

bash
jenv local 1.8.0_291

设置 shell 会话的 Java 版本

bash
jenv shell 11.0.12

移除 Java 版本

bash
jenv remove 1.8.0_291

插件管理

jenv 支持插件扩展功能,常用插件包括:

安装插件

bash
jenv enable-plugin maven
jenv enable-plugin gradle
jenv enable-plugin ant

禁用插件

bash
jenv disable-plugin maven

查看已启用的插件

bash
jenv plugins

常见问题

JAVA_HOME 未正确设置

原因:jenv 初始化失败

解决方法:确保正确配置了 jenv 的环境变量,并执行 jenv init - 来初始化。

无法添加 Java 版本

原因:Java 路径不正确或 Java 未正确安装

解决方法:检查 Java 安装路径是否正确,确保 Java 已正确安装。

插件启用失败

原因:插件依赖缺失

解决方法:确保已安装相应的构建工具(如 Maven、Gradle 等)。

最佳实践

  1. 为每个项目设置局部 Java 版本:在项目根目录使用 jenv local 命令设置项目特定的 Java 版本
  2. 使用 .java-version 文件:jenv 会自动识别项目根目录的 .java-version 文件来设置 Java 版本
  3. 启用相关插件:根据项目需要启用 Maven、Gradle 等插件,以确保构建工具使用正确的 Java 版本
  4. 定期更新 jenv:使用 git pull 命令更新 jenv

总结

jenv 是一个轻量级的 Java 版本管理工具,它可以帮助你轻松管理多个 Java 版本,为不同项目提供合适的 Java 环境。通过本文的教程,你应该能够掌握 jenv 的基本使用方法,为你的 Java 开发工作提供便利。