Windows上安装并使用SDKMAN详细教程(JDK多版本管理)

前言

对于Ja va、Groovy、Scala等语言的开发者来说，SDKMAN（Software Development Kit Manager）是一个耳熟能详的命令行工具。它能帮你轻松管理和切换不同版本的开发工具包，在Linux和macOS上配置起来行云流水。但到了Windows平台，事情就变得有点不一样了。

关键在于，SDKMAN本身并不能直接在Windows原生的CMD或PowerShell中运行，它需要一个Bash环境。因此，在Windows上使用SDKMAN，通常需要借助Git Bash这样的模拟环境。这也正是为什么需要这篇专门的指南——本文将一步步带你完成在Windows上，通过Git Bash安装并熟练使用SDKMAN来管理JDK的全过程。

一、准备工作：配置 Git Bash 支持 zip 命令

安装SDKMAN的第一步，就遇到了一个小门槛：它依赖zip命令。然而，Git for Windows默认只提供了unzip命令来解压，打包用的zip命令却缺席了。所以，我们的首要任务就是为Git Bash补上这个功能。

1. 获取 zip 工具

从哪里找Windows可用的zip命令呢？一个可靠的来源是GnuWin Files项目。这个站点提供了大量GNU工具在Windows上的移植版本。

• 站点地址： https://sourceforge.net/projects/gnuwin32/files/

你可以在其中找到zip工具的二进制压缩包。

2. 配置 Git Bash 支持 zip 命令

下载到合适的zip工具包（例如zip-3.0-bin.zip）及其可能依赖的bzip2包后，按照以下步骤操作：

1. 解压下载好的压缩文件。
2. 将解压得到的zip.exe和bzip2.dll文件，复制到Git的安装目录下的usrbin文件夹中。通常路径是：C:Program FilesGitusrbin。

⚠️ 注意：务必确保文件被放入usrbin目录，这是Git Bash能够识别命令的关键。

3. 验证配置是否成功

打开Git Bash，输入以下命令测试：

zip --version

如果终端能正常输出版本信息，恭喜你，准备工作就绪，可以开始安装SDKMAN了。

二、安装 SDKMAN

基础环境搞定后，接下来就是SDKMAN的正式安装。

1. 设置 SDKMAN 目录环境变量

首先，需要告诉系统SDKMAN要安装在哪里。注意，这里只需指定路径，不要手动创建这个目录，SDKMAN会自行创建。

export SDKMAN_DIR="/d/Ja vaDev/sdkman"

为了让这个设置永久生效，建议将其添加到Shell的配置文件中：

echo 'export SDKMAN_DIR="/d/Ja vaDev/sdkman"' >> ~/.bashrc

添加后，别忘了让配置立即生效：

source ~/.bashrc

可以验证一下环境变量是否设置成功：

echo $SDKMAN_DIR

如果终端回显/d/Ja vaDev/sdkman，说明配置正确。

2. 执行安装

运行以下命令，SDKMAN的安装脚本会自动执行下载和安装：

curl -s "https://get.sdkman.io" | bash

安装完成后，脚本通常会提示你执行一行初始化命令，类似这样：

source "$SDKMAN_DIR/bin/sdkman-init.sh"

执行它，SDKMAN就被激活了。

3. 验证安装

最后，用最直接的方式检查安装是否成功：

sdk version

如果屏幕上出现了SDKMAN的版本号，那么一切顺利，你已经拥有了一个强大的开发工具管理器。

三、使用 SDKMAN 管理 JDK

SDKMAN的核心魅力在于其简洁高效的多版本管理能力，下面以JDK为例看看怎么用。

1. 查看可用的 JDK 版本

sdk list ja va

这个命令会列出一个丰富的JDK版本列表。其中：

• Use列显示>>> 的，代表当前正在使用的版本。
• Status列标记为installed的，是已经安装在你机器上的版本。
• 没有任何特殊标识的，则是可供安装的候选版本。

2. 安装指定版本 JDK

比如，想安装OpenJDK 17的一个特定发行版（Temurin），命令很简单：

sdk install ja va 17.0.8-tem

3. 查看已安装的 JDK

再次运行sdk list ja va，你会发现刚刚安装的版本前面多了一个> 标识。

4. 查看 JDK 安装路径

想知道某个版本具体安装在哪里？用这个命令：

sdk home ja va 17.0.8-tem

它会输出该版本JDK的完整目录路径。

5. 切换默认 JDK 版本

这里有个重要提示：请使用管理员身份运行Git Bash。

如果不是管理员，切换版本时会看到提示：“cannot create current symlink, fall back to copy!”。这意味着创建软链接失败，SDKMAN会改用文件拷贝的方式。虽然也能用，但会导致sdk current ja va命令无法查看当前版本。为了获得完整功能，建议以管理员方式操作。

使用以下命令切换默认JDK，这个设置会持久生效：

sdk default ja va 17.0.8-tem

一个小技巧：在命令行输入sdk default ja va 后，连按两次Tab键，它会自动列出所有已安装的版本，方便你复制粘贴。

6. 临时切换 JDK 版本

如果只想在当前这次Git Bash会话中试用另一个版本，可以用：

sdk use ja va 11.0.20-tem

关闭终端后，下次打开又会恢复成默认版本。

7. 卸载 JDK

移除一个不再需要的版本同样直接：

sdk uninstall ja va 11.0.20-tem

四、配置系统环境变量

通过SDKMAN安装的JDK，默认只能在Git Bash环境中使用。如果你希望在Windows原生的CMD或PowerShell里也能直接调用ja va命令，就需要配置系统环境变量。

1. 问题现象

如果不配置，在CMD中运行ja va -version，你会看到熟悉的“不是内部或外部命令”错误。

2. 解决方案：配置 JA VA_HOME 和 Path

关键在于，我们要把系统环境变量指向SDKMAN管理的那个“当前”版本，这样当你在SDKMAN里切换版本时，系统环境也能同步。步骤如下：

1. 右键点击“此电脑” → “属性” → “高级系统设置”。
2. 点击“环境变量”。
3. 在“系统变量”区域点击“新建”，添加一个变量：
   • 变量名：JA VA_HOME
   • 变量值：D:Ja vaDevsdkmancandidatesja vacurrent（请根据你的SDKMAN_DIR调整盘符和路径）
4. 在“系统变量”中找到Path变量，选中并点击“编辑”。
5. 点击“新建”，添加一行：%JA VA_HOME%bin。
6. 依次点击“确定”保存所有更改。

⚠️ 核心要点：

• 路径中的current目录是一个符号链接，始终指向通过sdk default命令设置的默认版本。
• 这样一来，每当你在SDKMAN中切换默认版本，current链接的目标就会自动更新，Windows系统环境也就随之切换了。

3. 验证配置结果

重新打开一个CMD窗口，输入：

ja va -version

如果正确显示了Ja va版本信息，说明配置成功。

4. 验证版本切换功能

现在来测试联动效果：

# 在Git Bash（管理员模式）中切换默认版本
sdk default ja va 11.0.20-tem

# 然后打开一个新的CMD窗口验证
ja va -version

⚠️ 注意：由于Windows环境变量可能存在缓存，有时需要重新打开CMD窗口才能看到切换后的新版本生效。

五、结语

走到这里，你已经成功在Windows上搭建起了SDKMAN这座“多版本开发工具管理桥梁”。从配置Git Bash的基础环境，到安装SDKMAN并熟练使用其安装、切换、卸载JDK的核心命令，再到最后打通Windows原生命令行，整个过程一气呵成。

掌握了这套方法，你就能在Windows上同样优雅地管理Ja va、Groovy、Scala等多种语言和工具的不同版本，大幅提升开发环境的灵活性和效率。如果想进一步探索SDKMAN的更多高级特性，其官方文档始终是最好的去处。