必须先确认Windows 10版本≥2004（19041+）或使用Windows 11，并确保BIOS中虚拟化已启用；首选wsl --install一键安装，失败则按顺序手动启用子系统与虚拟机平台、重启、设默认WSL2、再安装Ubuntu发行版。
要在Windows系统中快速获得一个功能完整的Ubuntu子系统发行版用于开发或日常使用，必须先确认系统满足最低要求，再选择与当前环境匹配的安装路径。Windows 10版本需为2004及以上（内部版本19041+），或直接使用Windows 11；若系统版本过低、企业策略限制网络访问，或已安装旧版WSL但无法升级，默认的一键命令会失败，此时必须切换到手动启用流程。
检查系统版本与虚拟化状态
按下 Win + R，输入 winver 回车，确认版本号 ≥ 19041；接着按 Ctrl + Shift + Esc 打开任务管理器 → “性能”选项卡 → 查看“虚拟化”是否显示“已启用”。【若虚拟化为“已禁用”，需进入BIOS/UEFI开启Intel VT-x或AMD-V】
这一步跳过会导致后续所有安装命令报错或降级为WSL1，且无法运行Docker Desktop等依赖完整Linux内核的工具。
首选：一键命令安装（推荐联网新系统）
方法一：管理员身份运行 Windows 终端（PowerShell）→ 输入 wsl --install → 回车等待自动完成（含功能启用、内核下载、Ubuntu LTS安装）→ 重启电脑。
方法二：若只想安装Ubuntu而不触发其他默认行为，可改用带参数的命令：wsl --install -d Ubuntu-24.04（当前最新LTS版本）。该命令会跳过自动设置默认版本步骤，适合已手动启用功能但未设WSL2为默认的用户。
注意：此命令仅在系统中完全未安装WSL时生效；若已装过旧版并执行该命令，终端会直接输出帮助文本而非安装流程。
备用：分步手动启用（适用于命令失败或旧版系统）
第一步：以管理员身份打开 PowerShell → 运行：
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
第二步：继续运行：
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
第三步：重启计算机。
第四步：重启后再次以管理员身份打开 PowerShell → 运行：
wsl --set-default-version 2
第五步：运行 wsl --list --online 查看可用发行版 → 安装指定版本，例如：
wsl --install -d Ubuntu-22.04
这五步不可省略顺序。第二步若被跳过，WSL2将无法启动；第四步若遗漏，新安装的发行版仍会以WSL1模式运行，导致文件I/O性能下降50%以上，且不支持systemd。
离线安装（无网络或应用商店受限）
从另一台联网设备访问微软官方离线页 https://learn.microsoft.com/en-us/windows/wsl/install-manual ，下载对应版本的 Ubuntu-24.04.AppxBundle 文件（2026年10月最新版）。
将文件复制到目标电脑 → 右键重命名为 Ubuntu-24.04.zip → 解压 → 找到内部含 x64 字样的 .appx 文件 → 再次重命名为 .zip → 解压至非系统盘路径（如 D:\wsl\ubuntu2404）→ 双击目录中 ubuntu2404.exe 启动安装。
安装完成后，首次运行仍需设置用户名和密码，且【密码输入时屏幕不显示任何字符，输完直接回车即可】。
