如何在MacOS中管理多个Java版本

在这篇指南中，我们将完成使用jEnv命令行工具来管理MacOS系统中的三个JDK版本（Java8、Java11和Java17），大致流程为：

1. 使用MacOS的包管理工具Homebrew安装JDK环境变量管理工具jEnv
2. 使用Homebrewan安装多个JDK版本
3. 将多个Java版本的路径加入jEnv
4. 通过jEnv命令设置全局、项目和shell的Java版本

所有涉及的工具清单如下：

• Homebrew，Homebrew是一个免费的MacOS包管理工具，我们用它来安装JDK和JDK版本管理工具
• jEnv，jEnv是一个让你不需要记住如何设置JAVA_HOME环境变量的命令行工具，我们将用它来管理系统中的JDK版本

#安装步骤

#安装Homebrew

在MacOS上安装Homebrew，可以参考MacOS包管理工具-Homebrew

#安装jEnv

输出：

复制Running `brew update --preinstall`...
==> Downloading https://ghcr.io/v2/homebrew/core/jenv/manifests/0.5.4
######################################################################## 100.0%
==> Downloading https://ghcr.io/v2/homebrew/core/jenv/blobs/sha256:521a1ad6e28b90f1e37893d279950e35957a0580464d639ec74c3
==> Downloading from https://pkg-containers.githubusercontent.com/ghcr1/blobs/sha256:521a1ad6e28b90f1e37893d279950e35957
######################################################################## 100.0%
==> Pouring jenv--0.5.4.all.bottle.tar.gz
==> Caveats
To activate jenv, add the following to your ~/.zshrc:
  export PATH="$HOME/.jenv/bin:$PATH"
  eval "$(jenv init -)"
==> Summary
🍺  /usr/local/Cellar/jenv/0.5.4: 84 files, 73KB
==> Running `brew cleanup jenv`...
Disable this behaviour by setting HOMEBREW_NO_INSTALL_CLEANUP.
Hide these hints with HOMEBREW_NO_ENV_HINTS (see `man brew`). 

按照输出提示，我们需要将以下配置加入我们的shell配置文件中（如果系统使用的shell是bash，就将其加入~/.bash_profile或者~/.bashrc；如果使用的shell是zsh，就将其加入~/.zshrc文件中）。

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

我们可以直接将上述配置直接粘贴到shell配置文件中，也可以通过echo将其加入配置文件中：

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

不管通过哪种方式完成配置后，我们需要使配置立即生效：

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.
    PATH : /usr/local/Cellar/jenv/0.5.4/libexec/libexec:/Users/username/.nvm/versions/node/v17.3.0/bin:/Library/Frameworks/Python.framework/Versions/3.6/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/Applications/VMware Fusion.app/Contents/Public:/usr/local/share/dotnet:~/.dotnet/tools:/Library/Apple/usr/bin:/Library/Frameworks/Mono.framework/Versions/Current/Commands
[ERROR] Jenv is not loaded in your zsh
[ERROR] To fix :    echo eval "$(jenv init -)" >> /Users/username/.zshrc 

假如看到类似上面错误提示，暂且不用理会，因为我们还没将JDK添加到jEvn的管理中。如果我们在后续会使用到Maven还需要以下操作：

• 启用export插件

复制jenv enable-plugin export 

输出

复制You may restart your session to activate jenv export plugin echo export plugin activated 

• 启用Maven插件

输出

#安装Java

复制# 安装最新版OpenJDK
$ brew install --cask temurin

# 安装其他版本
$ brew tap homebrew/cask-versions
$ brew install --cask temurin11
$ brew install --cask temurin8 

#配置jEnv

#把所有JDK加入jEnv管理

首先，查看系统中有哪些JDK版本：

复制/usr/libexec/java_home -V 

输出：

复制Matching Java Virtual Machines (4):
    17.0.2 (x86_64) "Eclipse Temurin" - "Eclipse Temurin 17" /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home
    11.0.13 (x86_64) "Oracle Corporation" - "Java SE 11.0.13" /Library/Java/JavaVirtualMachines/jdk-11.0.13.jdk/Contents/Home
    1.8.202.08 (x86_64) "Oracle Corporation" - "Java" /Library/Internet Plug-Ins/JavaAppletPlugin.plugin/Contents/Home
    1.8.0_202 (x86_64) "Oracle Corporation" - "Java SE 8" /Library/Java/JavaVirtualMachines/jdk1.8.0_202.jdk/Contents/Home 

然后，将所有JDK的路径加入到jEnv中，语法如下：

例如：

复制jenv add /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home 

查看下jEnv管理的所有JDK版本：

输出：

复制 system
  1.8
  1.8.0.202
* 11 (set by /Users/username/.jenv/version)
  11.0
  11.0.13
  17
  17.0
  17.0.2
  openjdk64-17.0.2
  oracle64-1.8.0.202
  oracle64-11.0.13 

#设置全局JDK版本

#设置项目JDK版本

如果要为项目指定JDK版本，只需在项目根目录下使用以下命令即可，jEnv会在目录下生成.java-version文件来描述当前项目使用的JDK版本

#设置shell的JDK版本

#FAQ

#jEnv启用插件报错

问题信息

复制jenv: no such command `enable-plugin' 

解决方案
重启会话终端

#参考资料

• How to Manage Multiple Java Versions in MacOS (Updated 2021 + macOS Big Sur)