设备：windows11系统、安装好wsl2

安装之前建议保证系统盘有至少 40–60GB 可用空间；如果以后准备下载机器人模型、地图和仿真资源，预留 80GB 以上会更舒服

第一步：启用 WSL2 所需的 Windows 功能

安装成功后如何确认？

执行：

wsl -l -v

预期结果：

  NAME            STATE      VERSION
* Ubuntu-24.04    Running    2

然后进入 Ubuntu：

wsl -d Ubuntu-24.04

接下来才是正式安装 ROS 2 Jazzy。

使用管理员权限打开了 PowerShell，可以直接依次执行下面两个命令。

1. 启用适用于 Linux 的 Windows 子系统

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

2. 启用虚拟机平台

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

执行完成后，重启电脑。

第二步：检查 WSL2

重启后，再打开 PowerShell，执行：

wsl --status
wsl --version

然后使用正确的命令查看 Linux 发行版：

wsl --list --online

这里特别注意：

• 正确：--online

• 你之前输入的：--onine

如果能够正常显示 Ubuntu 的版本列表，就可以继续。

第三步：安装 Ubuntu 24.04

执行：

wsl --install -d Ubuntu-24.04

如果下载过程中再次遇到网络问题，可以尝试：

wsl --install -d Ubuntu-24.04 --web-download

安装完成后，根据提示创建 Linux 用户名和密码。密码输入时终端不会显示字符，这是正常的。

首次启动时，系统可能提示：

Create a default Unix user account:

例如输入：

moss

然后设置密码。注意，Linux 终端输入密码时不会显示任何字符，这是正常现象。

验证：

wsl -l -v

检查结果，预期类似：

NAME            STATE       VERSION
Ubuntu-24.04    Running     2

这表示 Ubuntu 已运行在 WSL2 上。

安装成功后如何确认？

执行：

wsl -l -v

预期结果：

  NAME            STATE      VERSION
* Ubuntu-24.04    Running    2

然后进入 Ubuntu：

wsl -d Ubuntu-24.04

接下来才是正式安装 ROS 2 Jazzy。