sdkman

JVM 与 SDK 版本管理器

补充说明

sdkman 通过 shell 函数 sdk 安装和切换 JDK、Maven、Gradle、Kotlin 等 SDK。它改变当前 shell 的 JAVA_HOME 和 PATH，不会自动跨终端生效。

常用示例

sdk version
sdk list java
sdk install java 21.0.5-tem
sdk install maven
sdk use java 21.0.5-tem
sdk default java 21.0.5-tem
sdk current
sdk current java
sdk outdated
sdk upgrade
sdk uninstall java 21.0.5-tem
sdk env

项目级 .sdkmanrc：

java=21.0.5-tem
maven=3.9.9

易错点与排错

• sdkman 是 shell 函数，必须先 source 初始化脚本；脚本里不能直接调用 sdk。
• sdk use 只影响当前 shell；新终端回到默认版本。
• sdk default 是全局默认；项目级切换用 .sdkmanrc + sdk env。
• Java 发行版和版本标识要写全（如 21.0.5-tem）；只写 21 可能匹配不到。
• JAVA_HOME 会被 sdkman 改写；IDE、构建工具和 CI 要确认读到的是同一个 JDK。
• 安装需要联网；公司代理和镜像要提前配置。
• Windows 原生环境支持有限；优先 WSL 或容器。
• 和系统包管理器、asdf、mise 混用会争抢 PATH；只保留一种。

相关命令

• java / javac — JDK 工具
• mvn / gradle — 构建工具
• asdf / mise — 多语言版本管理