WSL 安装 Ubuntu 完整步骤（Windows 10/11 通用，极简无脑版）

一、检查系统要求

• Windows 10 2004+ 或 Windows 11（推荐）
• 主板开启虚拟化（Intel VT-x / AMD-V），一般在 BIOS 里设置

二、一键安装（推荐）

1. 以管理员身份打开 PowerShell

   • Win+X → 选择 “终端 (管理员)” 或 “PowerShell (管理员)”

2. 执行：

   wsl --install --web-download

   • 自动启用 WSL、虚拟机平台、安装 WSL2 内核、下载 UbuntuMicrosoft Learn

3. 重启电脑（必须）

三、首次启动 Ubuntu

重启后会自动弹出 Ubuntu 窗口，或手动打开 “Ubuntu” 应用：

• 提示输入用户名：必须小写字母开头，只能是小写字母、数字、-
• 输入密码（输入时不显示）
• 确认密码

示例：

Enter new UNIX username: user01 New password: Retype new password:

四、验证安装

回到 PowerShell：

wsl -l -v

看到类似：

NAME STATE VERSION * Ubuntu Running 2

即成功。

五、国内常用初始化（换源 + 更新）

进入 Ubuntu 后：

# 备份原有源 sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak # 替换为清华源（复制整段） echo "deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble main restricted universe multiverse deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble-updates main restricted universe multiverse deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble-security main restricted universe multiverse deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble-backports main restricted universe multiverse" | sudo tee /etc/apt/sources.list # 更新 sudo apt update sudo apt upgrade -y

六、常见问题

1. 提示 0x800701bc

• 原因：缺少 WSL2 内核
• 解决：

  wsl --update

  或手动下载安装：https://aka.ms/wsl2kernel

2. 下载慢 / 卡住

• 重置商店缓存：

  wsreset.exe

• 或用离线包安装（适合国内）

3. 用户名报错 NAME_REGEX

• 只能用小写字母、数字、-，必须字母开头

4. 想装指定版本（如 22.04）

wsl --install -d Ubuntu-22.04

查看可安装列表：

wsl --list --online

七、卸载

wsl --unregister Ubuntu