WSL2 / Ubuntu 下用 SDKMAN 管理多版本 Java
在 WSL2 + Ubuntu 做 Java 后端开发时,经常会遇到这种组合:
- 老项目还在 Java 8
- 新项目已经是 Java 17 / 21
- 同一台机器、同一个终端,需要随时切换 JDK 版本
- Maven、脚手架脚本、命令行工具都要跟着走
如果你还在来回改 JAVA_HOME,强烈建议上 SDKMAN。
在 WSL2 或 Ubuntu 环境中开发 Java 时,常需同时维护多个 JDK 版本。SDKMAN 是管理多版本 SDK 的命令行工具,支持一键安装、切换及项目级版本固定。通过配置 .sdkmanrc 文件,可实现进入目录自动切换对应 Java 版本,避免手动修改 JAVA_HOME 环境变量带来的混乱。相比 update-alternatives 或手动配置,SDKMAN 更适用于多项目并行开发场景,能有效降低构建错误风险,提升开发效率。
在 WSL2 + Ubuntu 做 Java 后端开发时,经常会遇到这种组合:
如果你还在来回改 JAVA_HOME,强烈建议上 SDKMAN。
SDKMAN(Software Development Kit Manager)是 Linux/WSL 下专门用来管理多版本 JDK/SDK 的命令行工具。
它的几个关键特性非常适合日常开发:
.sdkmanrc)java对 WSL2 开发者来说,这几乎是目前体验最佳的多 JDK 管理方案。
在你的 Ubuntu / WSL2 终端中执行(保持网络能访问外网):
curl -s "https://get.sdkman.io" | bash
安装完成后,加载环境(新开终端也可以):
source "$HOME/.sdkman/bin/sdkman-init.sh"
验证是否安装成功:
sdk version
如果能正常输出版本信息,说明 SDKMAN 已经装好了。
sdk list java
常见推荐(以 Temurin 为例):
8.0.xxx-tem17.0.xxx-temsdk install java 8.0.392-tem
sdk install java 17.0.10-tem
查看本机已安装的版本:
sdk list java | grep installed
到这一步,你的 WSL2 环境里已经有多套 JDK 可以随时切换了。
想在当前终端切到 Java 17:
sdk use java 17.0.10-tem
验证一下:
java -version
javac -version
效果是:
如果想把某个版本设成「默认版本」(全局默认),可以用:
sdk default java 17.0.10-tem
这一块基本是 SDKMAN 的「杀手级」功能:让每个项目有自己的 Java 版本配置。
cd ~/project/mom/admin
sdk env init
执行后,项目根目录下会生成一个 .sdkmanrc 文件。
.sdkmanrcnano .sdkmanrc
写入你想绑定的 JDK 版本,例如:
java=17.0.10-tem
保存退出即可。
在项目目录中执行一次:
sdk env
或者直接开启自动模式(推荐):
sdk config set sdkman_auto_env true
之后的体验就是:
cd 进该项目目录,Java 自动切到 17多项目并行开发时,这一点可以极大降低「切错 JDK」导致的各种莫名报错。
在项目目录中执行:
java -version
mvn -v
通常会看到:
java 版本就是 .sdkmanrc 中配置的那一套mvn 使用的是同一套 JDK(JAVA_HOME 由 SDKMAN 管理)此时,让脚本或工具去执行 mvn compile,就不会再遇到类似:
invalid target release: 17
这类因为 JDK 不匹配导致的构建错误,也不需要手动调环境变量、改 IDE 里的 JDK 配置。
下面简单对比一下几种常见的多 JDK 管理方式:
| 方案 | 是否推荐 | 说明 |
|---|---|---|
| update-alternatives | ⚠️ 一般 | 只适合全局切换,项目混用不方便 |
| 手动改 JAVA_HOME | ❌ 不推荐 | 容易忘、步骤多、极易出错 |
| SDKMAN(推荐) | ✅ 强烈推荐 | 支持项目级自动切换,配置干净 |
在 WSL2 / Ubuntu 环境下,SDKMAN 的易用性和可维护性基本是完胜。
结合实际踩坑经验,有几条可以直接遵循:
JAVA_HOME 等系统环境变量如果你同时在用:
那么「SDKMAN + 项目级 .sdkmanrc」会让环境切换这件事变得非常顺手。
在 WSL2 / Ubuntu 下做 Java 开发,SDKMAN 基本可以视为多版本 JDK 管理的「默认解」。
只要把「每个项目都配一份 .sdkmanrc」养成习惯,环境切换这件事基本就从你的日常心智负担里消失了。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online
JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online
Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online