第 3 章：安装或核验 WSL 2

建议学时：2 小时｜状态：本机核验已实测；全新安装仅官方资料核对

学习目标

概念图 / 文本

wsl.exe（管理器） → WSL 2（运行模式） → Ubuntu（发行版） → uname（内核）

以管理员身份打开 PowerShell：

PowerShell

wsl --install

按提示重启，再从开始菜单打开 Ubuntu。该命令通常启用所需组件、安装 WSL 与默认 Ubuntu，并将新发行版设为 WSL 2。若已经装过 WSL，命令可能显示帮助而不是重复安装，此时转路线 B。

需要指定发行版时：

PowerShell

wsl --list --online
wsl --install -d Ubuntu

如果下载长期停在 0.0%，微软文档给出的候选方式是：

PowerShell

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

先记录完整错误；不要同时叠加多套手工修复。

在 PowerShell：

PowerShell

wsl --version
wsl --status
wsl --list --verbose

预期表格中 Ubuntu 的 VERSION 为 2。若为 1：

PowerShell

wsl --set-version Ubuntu 2

转换可能耗时并需要足够磁盘空间，执行前备份重要 Linux 文件。Codex 0.115 起不支持 WSL 1，因此本教材不提供 WSL 1 主流程。

PowerShell

wsl -d Ubuntu
wsl --set-default Ubuntu
wsl --update
wsl --shutdown

分别记录：

PowerShell

wsl --version
wsl --list --verbose
wsl -d Ubuntu -- uname -r

解释：第一项是 WSL 应用版本；表格中的 2 是架构模式；uname -r 是 Linux 内核版本。Ubuntu 版本要在发行版内部用 cat /etc/os-release 查看。