简介
本教程将指导您如何在 linux 系统上安装 SDKMAN 5.17.0。SDKMAN（Software Development Kit Manager）是一个用于管理多个软件开发工具包版本的工具，特别是用于管理Java生态系统中的多个版本，包括Java（JDK）、Groovy、Scala、Kotlin、Gradle、Maven等。SDKMAN让您可以轻松地在不同版本间切换，非常适合需要使用不同Java版本的开发者。
前置要求
- Linux 操作系统
- 稳定的网络连接
- 管理员权限（用于执行sudo命令）
- 基本的命令行操作知识
- 任何现代Linux发行版
- 与bash兼容的shell
- 基本的网络连接（用于下载SDK）
- unzip（解压工具）
- curl或wget（下载工具）
安装方法
使用官方安装脚本
1. 安装必要的依赖
sudo apt-get update && sudo apt-get install -y curl unzip zip # Debian/Ubuntu
# 或
sudo yum install -y curl unzip zip # CentOS/RHEL/Fedora这些工具是SDKMAN安装和操作所必需的。
2. 使用curl安装SDKMAN
curl -s "https://get.sdkman.io" | bash这将下载并运行SDKMAN的安装脚本。它会将SDKMAN安装到您的主目录下的.sdkman文件夹中，并修改您的shell配置文件以包含必要的初始化代码。
3. 初始化SDKMAN
source "$HOME/.sdkman/bin/sdkman-init.sh"这将在当前shell会话中初始化SDKMAN。下次启动shell时，SDKMAN会自动初始化（因为安装脚本已将初始化命令添加到您的shell配置文件中）。
离线安装（手动方法）
1. 下载SDKMAN压缩包
# 在有网络连接的计算机上执行
curl -s "https://get.sdkman.io" -o sdkman-install.sh这将下载SDKMAN安装脚本，但不执行它。
2. 查看安装脚本
cat sdkman-install.sh查看脚本内容，了解它将执行哪些操作。SDKMAN安装脚本会下载SDKMAN的ZIP文件，解压到~/.sdkman目录，并设置必要的环境变量。
3. 手动执行安装步骤
# 创建SDKMAN目录
mkdir -p ~/.sdkman/bin ~/.sdkman/candidates ~/.sdkman/ext
# 下载SDKMAN ZIP文件
curl -s "https://api.sdkman.io/2/broker/download/sdkman/zip/latest" -o sdkman.zip
# 解压ZIP文件
unzip sdkman.zip -d ~/.sdkman
# 设置权限
chmod +x ~/.sdkman/bin/sdkman-init.sh ~/.sdkman/bin/sdkman-*这些是安装脚本执行的主要步骤。通过手动执行这些步骤，您可以在离线环境中安装SDKMAN。
4. 配置shell初始化
# 将以下内容添加到~/.bashrc, ~/.zshrc或其他shell配置文件中
export SDKMAN_DIR="$HOME/.sdkman"
[[ -s "$HOME/.sdkman/bin/sdkman-init.sh" ]] && source "$HOME/.sdkman/bin/sdkman-init.sh"这将确保每次启动shell时SDKMAN都会自动初始化。
5. 初始化SDKMAN
source "$HOME/.sdkman/bin/sdkman-init.sh"在当前shell会话中初始化SDKMAN。
验证安装
1. 验证SDKMAN是否成功安装
sdk version如果SDKMAN成功安装，这将显示SDKMAN的版本号。
2. 列出可用的SDK
sdk list这将显示SDKMAN支持的所有SDK类型，例如java, kotlin, gradle, maven等。
3. 查看特定SDK的可用版本
sdk list java这将显示所有可用的Java版本。您可以将"java"替换为任何其他受支持的SDK。
4. 安装特定版本的JDK
# 安装最新的Java LTS版本
sdk install java
# 或安装特定版本
sdk install java 17.0.2-open这将下载并安装指定版本的Java。如果不指定版本，SDKMAN将安装该SDK的默认版本。
5. 验证Java安装
java -version验证Java是否已成功安装并可用。应该显示刚才安装的Java版本。
基本使用示例
列出所有可用的SDK
使用SDKMAN可以列出所有受支持的SDK。
sdk list此命令将显示SDKMAN支持的所有SDK，包括Java、Kotlin、Groovy、Gradle、Maven等。
列出特定SDK的可用版本
查看特定SDK的所有可用版本。
sdk list java此命令显示所有可用的Java版本。将"java"替换为任何其他支持的SDK名称，如"kotlin"、"gradle"等，以查看相应SDK的可用版本。
安装特定SDK的最新稳定版本
安装特定SDK的默认（通常是最新稳定）版本。
sdk install java安装Java的默认版本。您可以将"java"替换为任何其他支持的SDK名称。如果不指定版本，SDKMAN将安装该SDK的默认版本。
安装特定版本的SDK
安装特定SDK的指定版本。
sdk install java 17.0.2-open此命令安装OpenJDK 17.0.2版本。您可以从`sdk list java`命令显示的可用版本中选择特定版本。
使用特定版本的SDK
在当前终端会话中使用指定版本的SDK。
sdk use java 17.0.2-open此命令临时将当前终端会话的Java版本切换为17.0.2-open。此更改仅对当前终端会话有效，不会影响其他会话或之后的新会话。
设置默认SDK版本
设置特定SDK的默认版本，以后所有新的终端会话都将使用这个版本。
sdk default java 17.0.2-open此命令将Java 17.0.2-open设置为默认版本。所有新的终端会话将使用此版本的Java。
查看当前使用的SDK版本
查看当前使用的所有SDK版本。
sdk current显示当前终端会话中使用的所有SDK的版本。
查看特定SDK的当前版本
查看当前使用的特定SDK的版本。
sdk current java显示当前使用的Java版本。您可以将"java"替换为任何其他已安装的SDK。
卸载特定版本的SDK
卸载不再需要的SDK版本。
sdk uninstall java 17.0.2-open此命令卸载Java 17.0.2-open版本。如果该版本当前被设置为默认版本，您需要先将其他版本设置为默认版本。
升级SDKMAN
更新SDKMAN到最新版本。
sdk selfupdate此命令将SDKMAN更新到最新版本。SDKMAN团队定期发布更新，包括新功能和错误修复。
升级已安装的SDK
将已安装的SDK更新到最新版本。
sdk upgrade此命令检查并提示您更新所有已安装的SDK到最新稳定版本。
升级特定SDK
将特定SDK更新到最新版本。
sdk upgrade java此命令将Java更新到最新稳定版本。您可以将"java"替换为任何其他已安装的SDK。
离线使用SDKMAN
将SDKMAN设置为离线模式，这在没有互联网连接时很有用。
sdk offline enable此命令将SDKMAN设置为离线模式。在此模式下，您只能使用已安装的SDK版本。
恢复在线模式
将SDKMAN从离线模式恢复到在线模式。
sdk offline disable此命令将SDKMAN从离线模式恢复到在线模式，允许您安装新的SDK版本和更新SDKMAN。
设置项目特定的SDK版本
为项目目录设置特定的SDK版本（需要SDKMAN环境变量支持）。
# 在项目目录中创建.sdkmanrc文件
echo "java=17.0.2-open" > .sdkmanrc
# 在项目目录中激活特定SDK版本
sdk env此示例创建一个.sdkmanrc文件，指定项目应使用Java 17.0.2-open版本。当您在该目录中运行`sdk env`时，SDKMAN会自动切换到该版本。当您离开目录时，可以运行`sdk env clear`恢复到全局设置。
常见问题
问题：sdkman command not found
解决方案：确保软件已正确安装并添加到系统PATH中。可能需要重启终端或系统。
问题：安装过程中遇到权限错误
解决方案：确保您有管理员权限。在Windows上以管理员身份运行命令提示符，在Mac/Linux上使用sudo。
问题：安装后找不到sdkman命令
解决方案：SDKMAN需要在shell启动文件中添加配置。请确保您已经按照安装提示正确设置了环境变量，并重新加载shell配置。
# 检查SDKMAN是否正确安装
ls -la ~/.sdkman
# 手动初始化SDKMAN
source "$HOME/.sdkman/bin/sdkman-init.sh"
# 重新加载shell配置
source ~/.bashrc # 或 ~/.zshrc问题：SDKMAN安装或更新过程中出现网络错误
解决方案：这可能是由于网络连接问题。SDKMAN服务器可能暂时不可用，或者您的网络连接可能受到限制。
# 检查网络连接
ping -c 4 api.sdkman.io
# 如果有代理设置，可以尝试配置SDKMAN使用代理
export http_proxy=http://your.proxy.server:port
export https_proxy=http://your.proxy.server:port问题：安装SDK失败
解决方案：检查SDKMAN是否有足够的空间，以及您的网络连接。有时候也可能是特定SDK的临时问题。
# 检查磁盘空间
df -h ~
# 清理SDKMAN缓存
rm -rf ~/.sdkman/archives/*
rm -rf ~/.sdkman/tmp/*
# 尝试使用离线安装（如果已下载）
sdk install java 11.0.11.hs-adpt /path/to/downloaded/jdk.zip问题：在Windows上使用SDKMAN
解决方案：SDKMAN在Windows原生终端上可能会有问题。建议使用Git Bash或WSL（Windows Subsystem for Linux）。
# 这是Windows特有的问题问题：SDKMAN自身更新失败
解决方案：尝试手动更新SDKMAN或重新安装。
# 强制更新SDKMAN
sdk selfupdate force
# 如果仍然失败，可以尝试重新安装
rm -rf ~/.sdkman
curl -s "https://get.sdkman.io" | bash使用技巧
使用自动完成功能
SDKMAN提供了命令自动完成功能。在Bash或Zsh中，按下Tab键可以自动完成SDK名称和命令。
在项目中使用.sdkmanrc
创建一个.sdkmanrc文件来定义项目特定的SDK版本。这对于团队协作非常有用，确保所有开发人员使用相同版本的工具。
并行版本安装
SDKMAN允许您安装和管理同一SDK的多个版本，您可以轻松在它们之间切换，这对于测试应用程序与不同版本兼容性非常有用。
使用环境变量以编程方式切换版本
您可以在脚本中使用`JAVA_HOME=$SDKMAN_DIR/candidates/java/current` 来访问当前活动的Java版本的路径。
定期更新SDK目录
使用`sdk update`命令更新SDKMAN的本地SDK目录，以获取最新可用的SDK版本信息。
管理Gradle和Maven版本
SDKMAN不仅可以管理Java版本，还可以管理构建工具如Gradle和Maven的版本，使项目构建更加一致。
使用SDK别名
对于常用的SDK版本，您可以创建别名以便更快访问。例如：`sdk alias create java8 java 8.0.302-open`。
查看已安装的SDK
使用`sdk list java | grep installed`命令查看已安装的特定SDK版本。将"java"替换为任何其他SDK名称。
检查SDKMAN自身版本
使用`sdk version`命令检查SDKMAN的版本，确保您使用的是最新版本。
设置代理服务器
如果您在代理服务器后面，可以在~/.sdkman/etc/config文件中设置代理配置，使SDKMAN能够正常工作。
相关资源
SDKMAN官方网站
SDKMAN的官方网站，提供最新信息、文档和下载链接。
SDKMAN命令行帮助
SDKMAN所有可用命令的完整文档。
SDKMAN GitHub仓库
SDKMAN的源代码和问题跟踪器，您可以在这里报告错误或请求新功能。
SDKMAN Candidates API
SDKMAN支持的所有SDK候选的API端点，可用于脚本和自动化。
SDKMAN博客
SDKMAN的官方博客，提供新闻、教程和更新信息。
Java版本管理工具比较
Baeldung上的文章，比较SDKMAN与其他Java版本管理工具。
SDKMAN环境配置
关于如何使用.sdkmanrc文件为项目设置特定SDK版本的文档。
SDKMAN离线使用
关于如何在离线环境中使用SDKMAN的文档。
AdoptOpenJDK (Eclipse Temurin)
AdoptOpenJDK（现为Eclipse Temurin）是SDKMAN通常用作默认JDK的高质量OpenJDK发行版。
GraalVM
GraalVM是一个高性能JDK发行版，可通过SDKMAN安装。
总结
恭喜！您已成功安装了SDKMAN 5.17.0，并了解了如何使用它来管理Java及相关工具的多个版本。SDKMAN大大简化了Java开发环境的管理，使您能够轻松切换不同版本的JDK、构建工具和框架，而不会相互干扰。这对于多项目开发和测试不同Java版本的兼容性非常有价值。随着您对Java开发的深入，SDKMAN将成为您工具箱中不可或缺的一部分。