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 位系统

查看系统版本的方法：

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

1.2 开启 BIOS 虚拟化支持

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

1. 重启电脑，开机时按特定键进入 BIOS（通常是 F2、F10、F12 或 Del 键）

2. 寻找以下选项并启用：

   • Intel 处理器：Intel VT-x 或 Intel Virtualization Technology
   • AMD 处理器：SVM Mode 或 AMD-V
3. 保存设置并退出（通常按 F10）

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

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

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

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

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

1. 右键点击「开始」菜单
2. 选择「Windows Terminal (管理员)」或「PowerShell (管理员)」
3. 如果弹出 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 内核更新包

1. 访问微软官方下载页面：

   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

2. 点击下载 wsl_update_x64.msi 安装包
3. 双击运行下载的 MSI 文件，按照提示完成安装

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

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

wsl --set-default-version 2

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

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

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

步骤 1：打开 Microsoft Store

1. 点击任务栏上的「Microsoft Store」图标，或通过开始菜单搜索「Microsoft Store」

2. 如果无法打开，可直接访问网页版：

   https://www.microsoft.com/store/apps/windows

步骤 2：搜索并安装 Ubuntu

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

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

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

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

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

3.1 初次启动

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

1. 在开始菜单中找到并点击「Ubuntu」图标

2. 在 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.

按照提示依次输入：

1. Enter new UNIX username：输入用户名（建议使用小写字母，例如 jack 或 developer）
2. New password：输入密码（输入时屏幕不会显示字符，这是正常的）
3. 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

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

1. 在 PowerShell 中进入 WSL：

   wsl

2. 编辑 /etc/wsl.conf 文件：

   sudo nano /etc/wsl.conf

3. 添加以下内容：

   [user]
   default=root

4. 按 Ctrl+O 保存，Ctrl+X 退出

5. 在 PowerShell 中重启 WSL：

   wsl --shutdown

4.3 验证设置是否成功

1. 关闭所有 WSL 终端
2. 重新打开 Ubuntu
3. 如果看到命令提示符显示为 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 命令速查表

安全提示

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

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

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

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

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