前言
windows下安装多个jdk,Idea可以配置不同jdk版本,WSL2下如何实现。
SDKMAN 使用小结
WSL 下管理多版本 JDK 的实操记录。
一、为什么用 SDKMAN?
在 WSL 里开发 Java 项目,经常遇到不同项目需要不同 JDK 版本的情况。系统包管理器(apt)装 JDK 只能装一个版本,换版本很麻烦。SDKMAN 解决的就是这个问题:多版本安装 + 一键切换。
本质上和 Windows 下装多个 JDK、IDEA 里选一个用,是一回事。
二、安装
bash
curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"
装完验证:sdk version
命令持久化:
bash
echo 'export SDKMAN_DIR="$HOME/.sdkman"' >> ~/.bashrc
echo '[[ -s "$HOME/.sdkman/bin/sdkman-init.sh" ]] && source "$HOME/.sdkman/bin/sdkman-init.sh"' >> ~/.bashrc
source ~/.bashrc
# 新开一个 WSL 终端
sdk version
# 能正常输出版本号
三、常用命令
| 命令 | 作用 |
|---|---|
sdk list java |
查看所有可用版本 |
| `sdk list java | grep installed` |
sdk install java 17.0.13-tem |
安装指定版本 |
sdk uninstall java 17.0.13-tem |
卸载 |
sdk use java 17.0.13-tem |
当前终端临时切换 |
sdk default java 17.0.13-tem |
设置默认版本 |
sdk current java |
查看当前使用的版本 |
sdk home java 17.0.13-tem |
查看安装路径 |
四、安装目录
所有版本都装在同一个目录下:
bash
~/.sdkman/candidates/java/
目录结构:
~/.sdkman/candidates/java/
├── 11.0.31-tem/
├── 17.0.19-tem/
├── 8.0.472-amzn/
└── current -> 17.0.19-tem # 软链接,指向当前默认版本
current 是个软链接,指向你 sdk default 设置的版本。
五、和 IDEA 配合使用
在 IDEA 中配置 JDK 时,路径写:
\\wsl.localhost\Ubuntu\home\你的用户名\.sdkman\candidates\java\17.0.19-tem
注意:.sdkman 是隐藏目录,IDEA 文件选择器里默认看不到。按 Ctrl+H(Windows/Linux)或 Cmd+Shift+.(macOS)显示隐藏文件夹。
一个项目一个版本,互不干扰。 和 Windows 下用 IDEA 选 JDK 完全一样。
六、两个坑
坑一:sdk default 报错
Stop! Candidate version is not installed.
Tip: Run the following to install this version
$ sdk install java 25.0.3-tem
说明之前设置过默认版本,但那个版本被卸载了,默认指向了一个不存在的版本。
解决方法:
bash
# 重新指向一个已安装的版本
sdk default java 17.0.19-tem
# 或者直接编辑配置文件
echo 'sdkman_default_java=17.0.19-tem' >> ~/.sdkman/etc/config
坑二:java -version 和 sdk current java 不一致
java -version 显示一个版本,sdk current java 显示另一个或提示 Not using any version of java。
原因:PATH 里先找到了系统装的 JDK (/usr/lib/jvm/ 下的),优先级高于 SDKMAN。
解决方法:
bash
# 确认 SDKMAN 是否已初始化
source ~/.sdkman/bin/sdkman-init.sh
# 设置默认版本
sdk default java 17.0.19-tem
# 检查 which java 指向哪里
which java
# 应该指向 /home/xxx/.sdkman/candidates/java/current/bin/java
七、清理系统 JDK(可选)
如果想彻底只用 SDKMAN,可以把系统 APT 安装的 JDK 卸掉:
bash
# 确认包名
dpkg -l | grep openjdk
# 卸载
sudo apt purge openjdk-17-jdk
# 清理残留软链接
sudo rm -f /usr/bin/java /usr/bin/javac
hash -r
完成后 which java 应该指向 SDKMAN 目录。
八、总结
| 场景 | 命令 |
|---|---|
| 查看已装版本 | ls ~/.sdkman/candidates/java/ |
| 查看当前默认版本 | sdk current java |
| 切换默认版本 | sdk default java 版本号 |
| 临时切换 | sdk use java 版本号 |
| IDEA 配置路径 | \\wsl.localhost\Ubuntu\home\xxx\.sdkman\candidates\java\版本号 |
核心逻辑:SDKMAN 就是个多版本管理器,装、删、切三板斧够用了。剩下的就是让 IDEA 能正确找到这些版本。