WSL2 / Ubuntu 下用 SDKMAN 管理多版本 Java（项目级切换，真香）
在 WSL2 + Ubuntu 做 Java 后端开发时，经常会遇到这种组合：
- 老项目还在 Java 8
- 新项目已经是 Java 17 / 21
- 同一台机器、同一个终端，需要随时切换 JDK 版本
- Maven、脚手架脚本、命令行工具都要跟着走
如果你还在来回改JAVA_HOME，强烈建议上 SDKMAN。
一、SDKMAN 是什么，为什么适合 WSL2？
SDKMAN（Software Development Kit Manager）是 Linux/WSL 下专门用来管理多版本 JDK/SDK 的命令行工具。
它的几个关键特性非常适合日常开发：
- 同时安装多个 Java 版本（8/11/17/21 随便切）
- 一行命令切换 JDK，立刻生效
- 支持「项目级」固定 Java 版本（靠
.sdkmanrc） - 不污染系统全局环境变量
- Maven、Gradle、脚本直接跟随当前
java
对 WSL2 开发者来说，这几乎是目前体验最佳的多 JDK 管理方案。
二、在 Ubuntu / WSL2 安装 SDKMAN（一劳永逸）
在你的 Ubuntu / WSL2 终端中执行（保持网络能访问外网）：
curl -s "https://get.sdkman.io" | bash安装完成后，加载环境（新开终端也可以）：
source "$HOME/.sdkman/bin/sdkman-init.sh"验证是否安装成功：
sdk version如果能正常输出版本信息，说明 SDKMAN 已经装好了。
三、用 SDKMAN 安装多个 Java 版本
1. 查看可用 Java 版本
sdk list java常见推荐（以 Temurin 为例）：
- Java 8：
8.0.xxx-tem - Java 17：
17.0.xxx-tem
2. 安装 Java 8 和 Java 17（示例）
sdk install java 8.0.392-tem sdk install java 17.0.10-tem查看本机已安装的版本：
sdk list java | grep installed到这一步，你的 WSL2 环境里已经有多套 JDK 可以随时切换了。
四、全局切换 Java 版本（当前终端立即生效）
想在当前终端切到 Java 17：
sdk use java 17.0.10-tem验证一下：
java -version javac -version效果是：
- 当前 shell 立刻使用 Java 17
- Maven、脚手架、命令行工具都会跟着用这一套 JDK
如果想把某个版本设成「默认版本」（全局默认），可以用：
sdk default java 17.0.10-tem五、核心功能：项目级 Java 版本固定（强烈推荐）
这一块基本是 SDKMAN 的「杀手级」功能：让每个项目有自己的 Java 版本配置。
1. 进入项目目录
cd ~/project/mom/admin2. 初始化项目环境
sdk env init执行后，项目根目录下会生成一个.sdkmanrc文件。
3. 编辑.sdkmanrc
nano .sdkmanrc写入你想绑定的 JDK 版本，例如：
java=17.0.10-tem保存退出即可。
4. 启用项目级 Java 版本
在项目目录中执行一次：
sdk env或者直接开启自动模式（推荐）：
sdk config set sdkman_auto_env true之后的体验就是：
- 每次
cd进该项目目录，Java 自动切到 17 - 离开目录，Java 自动恢复为全局默认版本
多项目并行开发时，这一点可以极大降低「切错 JDK」导致的各种莫名报错。
六、SDKMAN + Maven + 工具钾 的实际效果
在项目目录中执行：
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 版本随项目走」，不要随系统走
- 老项目固定在 Java 8，新项目用 Java 17 / 21，可以长期共存
- 用 SDKMAN 统一管理 JDK，多 Maven 版本的话可以配合 Maven Toolchains 兜底
- 尽量避免再手动改
JAVA_HOME等系统环境变量
如果你同时在用：
- Maven / Gradle
- Spring Boot / 微服务项目
- 多个项目并行开发（单体 + 微服务 / 新老系统）
- 甚至本地脚本、自动化工具
那么「SDKMAN + 项目级.sdkmanrc」会让环境切换这件事变得非常顺手。
九、最后的一句话总结
在 WSL2 / Ubuntu 下做 Java 开发，SDKMAN 基本可以视为多版本 JDK 管理的「默认解」。
只要把「每个项目都配一份.sdkmanrc」养成习惯，环境切换这件事基本就从你的日常心智负担里消失了。
