SDKMAN! 使用指南

SDKMAN! 是一个用于管理多个软件开发工具包版本的命令行工具。

基本命令

安装 SDK

# 安装最新稳定版
sdk install java# 安装特定版本
sdk install scala 3.4.2# 安装本地版本
sdk install groovy 3.0.0-SNAPSHOT /path/to/groovy-3.0.0-SNAPSHOT
sdk install java 17-zulu /path/to/java-home

版本管理

# 列出所有可用的 SDK
sdk list# 列出特定 SDK 的版本
sdk list java# 使用特定版本（仅当前终端）
sdk use scala 3.4.2# 设置默认版本
sdk default scala 3.4.2# 查看当前使用的版本
sdk current java# 查看所有 SDK 当前版本
sdk current# 移除已安装的版本
sdk uninstall scala 3.4.2

项目特定配置

# 初始化项目特定的 SDK 配置
sdk env init# 应用 .sdkmanrc 中的配置
sdk env# 安装 .sdkmanrc 中指定的所有 SDK
sdk env install# 清除环境配置，恢复默认版本
sdk env clear

系统维护

# 更新 SDKMAN!
sdk selfupdate
sdk selfupdate force  # 强制更新# 更新 SDK 列表
sdk update# 检查可升级的版本
sdk upgrade
sdk upgrade springboot  # 检查特定 SDK# 清理缓存
sdk flush# 获取 SDK 安装路径
sdk home java 21.0.4-tem

离线模式

# 启用离线模式
sdk offline enable# 禁用离线模式
sdk offline disable

配置

配置文件位置：~/.sdkman/etc/config

主要配置项：

• sdkman_auto_answer: 设置是否自动回答（CI 环境推荐）
• sdkman_auto_env: 是否自动加载项目环境
• sdkman_auto_complete: 是否启用自动补全
• sdkman_beta_channel: 是否订阅测试版通道
• sdkman_debug_mode: 是否启用调试模式
• sdkman_colour_enable: 是否启用彩色输出

帮助命令

# 查看通用帮助
sdk help# 查看特定命令的帮助
sdk help install

注意事项

1. 在脚本中使用时，可以设置 sdkman_auto_answer=true 实现自动化
2. 不要手动删除 .sdkman/tmp 目录，请使用 sdk flush 命令
3. 离线模式下部分功能将受限，但基本操作仍可使用
4. 使用 sdk env 功能可以方便地管理项目特定的 SDK 版本