Windows 安装 SDKMAN + Maven 完整操作总结

整个过程分为全程在 Windows 终端操作，无需复杂手动配置，具体流程如下：

一、前置准备（Windows 端）

确保 Windows 满足以下条件（否则需先配置）：

1. 系统版本要求：Windows 10 2004 及以上（内部版本 ≥ 19041）或 Windows 11
2. 启用必要功能：
   • 打开「控制面板 → 程序 → 启用或关闭 Windows 功能」
   • 勾选「适用于 Linux 的 Windows 子系统」和「虚拟机平台」
   • 点击「确定」后重启电脑生效

二、安装 WSL 与 Ubuntu 24.04

1. 打开 Windows 终端（管理员或普通权限均可），执行 Ubuntu 24.04 安装命令：

   wsl --install Ubuntu-24.04
   

2. 等待下载与安装完成（终端提示「已成功安装分发」），系统会自动启动 Ubuntu 24.04
3. 初始化 Ubuntu 账户（关键步骤，非 root 用户）：
   • 提示 Create a default Unix user account: 时，输入自定义用户名（如 ubuntu，勿用 root）
   • 提示 Enter new UNIX password: 时，输入密码（输入不显示字符，正常）
   • 提示 Retype new UNIX password: 时，再次输入密码确认
4. 验证 Ubuntu 安装成功：
   终端提示符变为 用户名@localhost:~$，执行以下命令验证：

   cat /etc/os-release  # 显示 Ubuntu 24.04 版本信息
   whoami               # 显示当前非 root 用户名
   

三、安装 SDKMAN（开发工具管理器）

SDKMAN 用于一键管理 Java、Maven 等工具，自动配置环境变量，步骤如下：

1. 安装 SDKMAN 依赖（Ubuntu 默认缺 unzip，需手动安装）：

   sudo apt update && sudo apt install -y curl unzip zip
   

   输入之前创建的用户密码（sudo 授权），等待依赖安装完成
2. 执行 SDKMAN 官方安装脚本：

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

3. 永久激活 SDKMAN（后续所有终端均可使用）：

   echo 'source "$HOME/.sdkman/bin/sdkman-init.sh"' >> ~/.bashrc && source ~/.bashrc
   

   • 若终端是 Zsh（Ubuntu 部分版本默认），将 .bashrc 替换为 .zshrc
4. 验证 SDKMAN 安装：

   sdk version  # 显示 SDKMAN 版本号即成功（如 script: 5.18.2）
   

四、安装 Java 环境（Maven 必需依赖）

Maven 运行依赖 Java，通过 SDKMAN 一键安装稳定版 Java：

1. 查看可用 Java 版本（可选，了解最新长期支持版）：

   sdk list java
   

2. 安装推荐版本（如 Amazon Corretto 17，长期支持版）：

   sdk install java 17.0.10-amzn  # 版本号替换为 list 中显示的 Identifier
   

   • 安装时提示「是否设为默认 Java 版本」，输入 Y 确认
3. 验证 Java 安装：重启终端查看

   java -version  # 显示 Java 版本信息即成功（如 openjdk version "17.0.10"）
   

五、安装与管理 Maven

通过 SDKMAN 安装 Maven，自动关联 Java 环境，无需手动配置：

1. 安装 Maven（默认安装最新稳定版）：

   sdk install maven
   

   • 提示「是否设为默认 Maven 版本」，输入 Y 确认
2. 验证 Maven 安装

   mvn -v  # 显示 Maven 版本+关联的 Java 信息即成功
   

3. （可选，推荐）配置阿里云镜像加速（国内下载依赖更快）：
   • 编辑 Maven 配置文件：

     sudo vim ~/.sdkman/candidates/maven/current/conf/settings.xml
     

   • 在 <mirrors> 标签内添加（无 <mirrors> 则手动创建）：

     <mirrors>
         <mirror>
             <id>aliyunmaven</id>
             <mirrorOf>central</mirrorOf>
             <name>阿里云中央仓库</name>
             <url>https://maven.aliyun.com/repository/public</url>
         </mirror>
     </mirrors>
     

   • Vim 保存退出：按 Esc → 输入 :wq → 回车

六、后续常用操作（维护与管理）

1. Maven 版本管理（SDKMAN 命令）

• 列出已安装 Maven 版本：sdk list maven
• 切换临时版本：sdk use maven 3.8.8（替换为实际版本号）
• 设置默认版本：sdk default maven 3.9.6
• 升级 Maven：sdk upgrade maven
• 卸载无用版本：sdk uninstall maven 3.8.8

2. WSL 启动与关闭

• 启动 Ubuntu 24.04：wsl -d Ubuntu-24.04（Windows 终端执行）
• 关闭所有 WSL 实例：wsl --shutdown（解决卡顿/报错时使用）

总结

整个流程核心优势：

1. WSL 实现 Windows 与 Ubuntu 无缝集成，无需双系统
2. SDKMAN 简化工具管理，自动配置环境变量，无需手动修改 profile/.bashrc
3. 全程命令行操作，步骤清晰，适合开发环境快速搭建
   最终可在 WSL 的 Ubuntu 24.04 中直接使用 mvn 命令进行项目构建、依赖管理等开发操作，与原生 Linux 环境完全一致。