Windows 全新安装 WSL 与 Ubuntu 完整教程

📋 写在前面

本文将详细介绍如何在 Windows 系统上从零开始安装 WSL（Windows Subsystem for Linux），并配置 Ubuntu 发行版。教程将涵盖所有必要步骤，包括环境检查、功能启用、发行版安装，以及如何将默认登录用户设置为 root。

适用系统：Windows 10（2004 版本及以上）和 Windows 11
预计耗时：20-30 分钟（取决于网络速度）

第一部分：安装前的准备工作

1.1 检查系统要求

在开始安装前，请确认你的系统满足以下要求：

Windows 10：版本 2004（Build 19041）或更高
Windows 11：所有版本都支持
系统架构：64 位系统

查看系统版本的方法：

按下 Win + R 键
输入 winver 并回车
在弹出的窗口中查看版本号

1.2 开启 BIOS 虚拟化支持

为确保 WSL 2 能够正常运行，需要确保 CPU 虚拟化技术已开启：

重启电脑，开机时按特定键进入 BIOS（通常是 F2、F10、F12 或 Del 键）
寻找以下选项并启用：
- Intel 处理器：Intel VT-x 或 Intel Virtualization Technology
- AMD 处理器：SVM Mode 或 AMD-V
保存设置并退出（通常按 F10）

💡 提示：大多数现代电脑默认已开启虚拟化，可以先跳过此步骤，若后续安装遇到问题再检查。

第二部分：安装 WSL（三种方法任选其一）

🔥 方法一：极速一键安装（推荐，适合 Windows 10 2004+ / Windows 11）

这是微软官方推荐的最简单方法，一条命令即可完成所有操作。

步骤 1：以管理员身份打开 PowerShell

右键点击「开始」菜单
选择「Windows Terminal (管理员)」或「PowerShell (管理员)」
如果弹出 UAC 提示，点击「是」

步骤 2：执行安装命令

在 PowerShell 窗口中输入以下命令：

wsl --install

这条命令会自动完成：

✅ 启用 WSL 所需的所有 Windows 功能
✅ 下载并安装默认的 Ubuntu 发行版
✅ 将 WSL 2 设置为默认版本

步骤 3：重启电脑

安装完成后，系统会提示重启。保存好工作后，立即重启电脑。

🔧 方法二：分步手动安装（适合所有 Windows 10/11 版本）

如果你希望清晰了解每一步的操作，或者系统版本较旧，可以使用这个方法。

第 1 步：启用 WSL 相关功能

以管理员身份打开 PowerShell，依次执行以下两条命令：

# 启用 WSL 功能
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# 启用虚拟机平台（WSL 2 需要）
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

执行完成后，必须重启电脑。

第 2 步：下载并安装 WSL 2 内核更新包

访问微软官方下载页面：
```
https://learn.microsoft.com/zh-cn/windows/wsl/install-manual#step-4---download-the-linux-kernel-update-package
```
🔗 备用链接：https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi
点击下载 wsl_update_x64.msi 安装包
双击运行下载的 MSI 文件，按照提示完成安装

第 3 步：将 WSL 2 设为默认版本

重启后在管理员 PowerShell 中执行：

wsl --set-default-version 2

看到提示信息 "操作成功完成" 即可。

📦 方法三：通过 Microsoft Store 安装（可视化操作）

如果你更喜欢图形界面，可以通过 Microsoft Store 安装。

步骤 1：打开 Microsoft Store

点击任务栏上的「Microsoft Store」图标，或通过开始菜单搜索「Microsoft Store」
如果无法打开，可直接访问网页版：
```
https://www.microsoft.com/store/apps/windows
```

步骤 2：搜索并安装 Ubuntu

在 Store 右上角搜索框输入 "Ubuntu"
从搜索结果中选择你想要的版本（建议选择最新的 LTS 版本，如 Ubuntu 24.04 LTS）

直接访问 Ubuntu 24.04 的商店页面：

https://www.microsoft.com/store/apps/9nz3klhxdjp5

点击「获取」或「安装」按钮
等待下载和安装完成

第三部分：首次启动 Ubuntu 并创建用户

3.1 初次启动

安装完成后，可以通过以下任一方式启动 Ubuntu：

在开始菜单中找到并点击「Ubuntu」图标
在 PowerShell 或命令提示符中输入：
```
wsl
```
或
```
ubuntu
```
⚠️ 注意：具体命令取决于安装的版本，可能是 ubuntu、ubuntu2204 或 ubuntu2404

3.2 设置用户名和密码

首次启动时，Ubuntu 会进行初始化配置，大约需要 1-2 分钟。随后会看到以下提示：

Installing, this may take a few minutes...
Please create a default UNIX user account.

按照提示依次输入：

Enter new UNIX username：输入用户名（建议使用小写字母，例如 jack 或 developer）
New password：输入密码（输入时屏幕不会显示字符，这是正常的）
Retype new password：再次输入密码确认

设置完成后，你会看到类似这样的欢迎信息：

Welcome to Ubuntu 24.04 LTS (GNU/Linux 5.15.90.4-microsoft-standard-WSL2 x86_64)

现在你已经成功进入 Ubuntu 环境，使用的是刚才创建的普通用户。

第四部分：将默认登录用户设置为 root

4.1 查看已安装的发行版名称

在 Windows 的 PowerShell 或命令提示符中，输入：

wsl --list

你会看到类似下面的输出：

适用于 Linux 的 Windows 子系统:
Ubuntu-24.04 (默认)

记下这个名称，下一步会用到。

4.2 修改默认用户为 root

✅ 方法一：使用发行版专用命令（推荐）

在 PowerShell 中输入以下命令，将 <发行版名称> 替换为你刚才查到的名称：

<发行版名称> config --default-user root

例如，如果你安装的是 Ubuntu 24.04：

Ubuntu-24.04 config --default-user root

✅ 方法二：使用通用命令

如果方法一不生效，可以尝试：

wsl --set-default-user root

✅ 方法三：编辑配置文件（高级用户）

在 PowerShell 中进入 WSL：
```
wsl
```
编辑 /etc/wsl.conf 文件：
```
sudo nano /etc/wsl.conf
```
添加以下内容：
```
[user]
default=root
```
按 Ctrl+O 保存，Ctrl+X 退出
在 PowerShell 中重启 WSL：
```
wsl --shutdown
```

4.3 验证设置是否成功

关闭所有 WSL 终端
重新打开 Ubuntu
如果看到命令提示符显示为 root@主机名:~#，说明设置成功！

第五部分：安装后的配置与验证

5.1 验证 WSL 版本

在 PowerShell 中执行：

wsl --list --verbose

应该看到类似输出：

  NAME            STATE           VERSION
* Ubuntu-24.04    Running         2

确认 VERSION 列为 2。

5.2 更新软件源和系统包

以 root 身份登录 Ubuntu 后，建议立即更新系统：

# 更新软件包列表
apt update

# 升级所有已安装软件
apt upgrade -y

# 安装一些常用工具（可选）
apt install -y curl wget git vim

5.3 测试 Windows 与 Linux 文件互访

从 Linux 访问 Windows 文件：
```
ls /mnt/c/Users
```
应该能看到你的 Windows 用户目录
从 Windows 访问 Linux 文件：
在文件资源管理器的地址栏输入：
```
\\wsl$\Ubuntu-24.04\home
```
可以直接访问 Linux 的家目录

常见问题与解决方案

❓ 问题 1：安装时提示 "0x8007019e" 错误

原因：WSL 内核组件未安装
解决：下载并安装 WSL2 内核更新包（参考第二部分方法二的第 2 步）

❓ 问题 2：wsl --install 命令找不到

原因：Windows 版本过低
解决：使用方法二的分步安装方式

❓ 问题 3：修改默认用户后不生效

原因：发行版名称输入错误
解决：使用 wsl --list 确认正确的发行版名称，注意大小写和空格

❓ 问题 4：启动 Ubuntu 时报错 "参考的对象类型不支持尝试的操作"

原因：网络代理冲突
解决：关闭代理软件后重启 WSL

附录：常用 WSL 命令速查表

命令	说明
`wsl --install`	一键安装 WSL 和默认 Ubuntu
`wsl --list --online`	查看可安装的 Linux 发行版
`wsl --install -d <发行版>`	安装指定发行版
`wsl --list --verbose`	查看已安装的发行版及 WSL 版本
`wsl --set-version <发行版> 2`	将指定发行版切换到 WSL 2
`wsl --set-default-version 2`	设置默认使用 WSL 2
`wsl --shutdown`	立即终止所有 WSL 实例
`wsl ~ -d <发行版>`	直接进入指定发行版的 home 目录

安全提示

虽然将默认用户设置为 root 可以免去频繁输入 sudo 的麻烦，但请注意：

⚠️ root 用户拥有系统的最高权限，任何操作都可能影响系统稳定性。建议：

日常开发和文件编辑使用普通用户
仅在需要执行系统级管理任务时切换到 root
如果不小心误操作（如删除系统文件），可能导致 Ubuntu 无法使用，需要重新安装

如需切换回普通用户，只需重复第四部分的步骤，将 root 替换为你的普通用户名即可。

🎉 恭喜！你已经成功完成了 WSL 和 Ubuntu 的完整安装与配置。现在可以开始在 Windows 上享受 Linux 的开发体验了！