程序员食堂
拥有10年丰富经验的bug解决专家,顺便也制造过不少bug。

一、检查系统要求

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

 

二、一键安装(推荐)

  1. 以管理员身份打开 PowerShell
     
    • Win+X → 选择 “终端 (管理员)” 或 “PowerShell (管理员)”
     
  2. 执行:
     
    wsl --install --web-download
     

    image

     

    • 自动启用 WSL、虚拟机平台、安装 WSL2 内核、下载 UbuntuMicrosoft Learn
     
  3. 重启电脑(必须)
     
 

 

三、首次启动 Ubuntu

 
重启后会自动弹出 Ubuntu 窗口,或手动打开 “Ubuntu” 应用:
 
  • 提示输入 用户名:必须小写字母开头,只能是小写字母、数字、-
  • 输入密码(输入时不显示)
  • 确认密码
 
示例:
 
Enter new UNIX username: user01
New password:
Retype new password:

 

image

 

 

 

四、验证安装

 
回到 PowerShell:
 
wsl -l -v

 

 
看到类似:
  NAME      STATE           VERSION
* Ubuntu    Running         2

 

image

 

即成功。
 

 

五、国内常用初始化(换源 + 更新)

 
进入 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

 
 

2. 下载慢 / 卡住

 
  • 重置商店缓存:
    wsreset.exe

     

     
  • 或用离线包安装(适合国内)
 

3. 用户名报错 NAME_REGEX

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

4. 想装指定版本(如 22.04)

wsl --install -d Ubuntu-22.04

 

 
查看可安装列表:
 
wsl --list --online

 

 

 

七、卸载

wsl --unregister Ubuntu

 

 



微信图片_20251230145111_107_204

 

 
 
posted on 2026-04-28 09:29  程序员食堂  阅读(962)  评论(0)    收藏  举报