前言
最近项目前后端进行升级,需要在jdk8和jdk17两个版本切换。最简单的是通过手动切换,但切换过程太繁琐,修改环境变量,达到切换目的。于是尝试其它解决方案,最终确实使用sdkman工具。
sdkman 是一款面向Java开发者的命令行工具,旨在简化操作系统上SDKs的管理。支持跨平台使用,提供便捷的版本控制和切换功能,通过维护候选SDK列表,让用户能够轻松安装、更新和卸载各类软件开发工具包。
下面详细介绍windows下和linux下安装过程。
(1)、 Windows 安装
目前 Windows 有两种安装方式,WSL 和 Git Bash 的方式,Git 大家电脑中应该都有安装,因此下面基于 Git Bash 进行安装 sdkman 。
1、安装前准备: 首先安装 sdkman 会使用到 unzip、zip、curl、sed 命令, Git缺少 zip :
zip -v
如果未找到,下载 zip 包:
https://sourceforge.net/projects/gnuwin32/files/zip/3.0/

下载后,将解压后 bin 目录下的 zip.exe 拷贝到 Git 安装目录下 mingw64/bin 目录下:

同时 zip 还依赖 bzip2 ,因此还要下载 bzip2 包:
https://sourceforge.net/projects/gnuwin32/files/bzip2/1.0.5/

下载后,将解压后 bin 目录下的 bzip2.dll 拷贝到 Git 安装目录下 mingw64/bin 目录下:

然后再次尝试 zip 命令,可以看到已经可以了:

2、安装sdkman: 接下来下载安装 sdkman ,在 Git Bash 中执行如下操作:
curl -s "https://get.sdkman.io" | bash

安装完成后,将 sdkman 添加到环境变量中:
source "$HOME/.sdkman/bin/sdkman-init.sh"

每次启动终端时自动加载 sdkman,将以下行添加到.zshrc文件中:
echo 'source "$HOME/.sdkman/bin/sdkman-init.sh"' >> ~/.zshrc
重新加载 .zshrc:
source ~/.zshrc
验证环境:
sdk version

3、sdkman 使用
3.1 查看所有可用的SDK
sdk list

可以看到非常多的应用,而不限于 JDK 。
3.2 查看所有指定类型可用的SDK:
sdk list java

3.3 安装指定类型版本的SDK:
sdk install java 21.0.2-open

3.4 切换并使用指定类型版本的SDK
sdk use java 21.0.2-open

验证 java 版本:
java --version

3.5 设置默认版本
sdk default java 21.0.2-open

3.6 查看当前使用的 SDK
sdk current

3.7 查看当前使用的指定类型的 SDK
sdk current java

3.8 查看 SDK 安装目录
sdk home java 21.0.2-open

3.8 卸载指定类型版本的SDK
sdk uninstall java 21.0.2-open
3.9 升级 sdkman
sdk selfupdate
(2)、Linux下安装sdkman
和Windows下安装过程是一样的,linux系统默认缺少一些命令,我们需要提前安装好。
2.1.需要安装curl,unzip,zip
sudo apt-get install curl
sudo apt-get install unzip
sudo apt-get install zip
2.2安装sdkman
curl -s "https://get.sdkman.io" | bash
2.3安装完成后执行
source "$HOME/.sdkman/bin/sdkman-init.sh"
2.4验证
sdk version

sdkman会自动为设置相应的环境变量。如果想确保在所有终端会话中都使用 sdkman设置的 Java 版本,可以手动设置 JAVA_HOME 环境变量。在 .zshrc 文件中添加以下行:
export JAVA_HOME="$HOME/.sdkman/candidates/java/current"
export PATH="JAVA_HOME/bin:PATH"
重新加载 .zshrc:
source ~/.zshrc
(3)、常见问题:
cmd命令窗口直接java -version 找不到命令,需要在环境变量设置路径:
JDK安装路径默认情况下在$HOME/.sdkman/candidates/java/current/bin,具体路径可以通过命令在 Git Bash 中查看:
echo "$HOME/.sdkman/candidates/java/current/bin"
/c/Users/XXX/.sdkman/candidates/java/current/bin
注:XXX是你的用户名
3. 1 配置环境变量
操作步骤:我的电脑-》右键属性-》高级系统设置-》环境变量-》系统环境-》系统变量:
添加: JAVA_HOME:C:\Users\Administrator\.sdkman\candidates\java\current

Path 中添加:%JAVA_HOME%\bin

3. 2 验证是否生效
打开终端,输入java -version ,验证是否是自己刚刚安装的版本
java -version

(4)、卸载 sdkman
4.1. 删除 sdkman 目录
删除 sdkman 安装目录:
rm -rf ~/.sdkman
4.2. 移除配置文件中的 sdkman 配置
编辑的 shell 配置文件(例如 .zshrc),删除与 sdkman 相关的行:
nano ~/.zshrc
找到并删除以下行:
source "$HOME/.sdkman/bin/sdkman-init.sh"
export JAVA_HOME="$HOME/.sdkman/candidates/java/current"
export PATH="JAVA_HOME/bin:PATH"
保存并退出(在 nano 中使用 Ctrl+X 然后按 Y 确认保存)。
4.3.重新加载 shell 配置文件
删除配置行后,重新加载 shell 配置文件:
source ~/.zshrc
(5)、jdk版本选择
Jdk list java 列出来的jdk版本,都是在openJdk上扩展的,基本功能都差不多,根据需要自行下载,目前在开发过程中主要用到的是jdk8、jdk17、jdk21等,比如在本人电脑上安装了这三个版本:8.0.422-zulu、17.0.12-zulu、21.0.2-open。
切换到21,需要执行下面两个命令:
sdk use java 21.0.2-open
sdk default java 21.0.2-open
下载安装包在:C:\Users\Administrator\.sdkman\tmp目录下

安装位置:C:\Users\Administrator\.sdkman\candidates\java目录下

Current是当前使用的jdk。
提示: 刚开始安装sdkman选择d盘指定目录,但zshrc文件修改配置不行,折腾半天,最后还是换回了默认路径。不知道为什么,没再研究.....
(6)、idea配置
注意:Idea中配置jdk,和手动安装的设置一样,设置成current目录不行,切换后,无法自动切换。所以如果需要在各个jdk版本间切换,最好在sdk中都选择上,sdkman切换后,idea手动再选择下:

Sdks都添加上:

Project中指定当前使用中的jdk:

启动入口,jdk如果没有改过来,也需要手动切换下:

至此,安装sdkman管理多个jdk版本,并在idea中使用过程就完结了。
在安装过程中,可能会碰到其它问题,系统环境不同,问题都可能不尽相同,根据不同问题查找解决方案,实现sdkman对jdk管理的目的。
sdkman工具,是非常好用的跨平台管理jdk工具,希望能帮助到切换jdk烦恼的你!
参考文章: