在 Windows 上安装和配置 WSL（适用于 Linux 的 Windows 子系统）

在 Windows 上安装和配置 WSL（适用于 Linux 的 Windows 子系统）

本教程将指导你在 Windows 10 或 Windows 11 上安装适用于 Linux 的 Windows 子系统（WSL），并提供解决安装过程中可能遇到的错误代码 0x8024001e 的方法。

前提条件

  • 操作系统：Windows 10 版本 2004 或更高，或 Windows 11。
  • 管理员权限：需要以管理员身份运行命令。
  • 磁盘空间：至少 5GB 可用空间用于安装 WSL 和 Linux 发行版。

步骤 1：启用 WSL 和虚拟机平台

  1. 以管理员身份打开 命令提示符（搜索 cmd，右键选择“以管理员身份运行”）。
  2. 运行以下命令启用 WSL 和虚拟机平台：
1

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

1
2
3
4
5
3. 重启系统以应用更改。

## 步骤 2：安装 WSL
1. 打开 **命令提示符** 或 **PowerShell**（以管理员身份）。
2. 运行以下命令自动安装 WSL 及默认的 Ubuntu 发行版：

wsl –install

1
2
3
4
5
3. 安装完成后，重启系统。
4. WSL 将自动配置 Ubuntu，首次启动时需要设置用户名和密码。

## 步骤 3：验证安装
1. 打开命令提示符，运行：

wsl –list –all

1
2
你应该看到已安装的 Linux 发行版（如 Ubuntu）。
2. 运行以下命令检查 WSL 版本：

wsl –version

1
3. 设置 WSL 2 为默认版本（推荐）：

wsl –set-default-version 2

1
2
3
4
5
## 解决错误代码 0x8024001e
如果在安装过程中遇到错误 **0x8024001e**（通常与 Windows Update 相关），请按照以下步骤排查：

### 1. 重启 Windows Update 服务
- 以管理员身份运行命令提示符，执行：

net stop wuauserv
net start wuauserv

1
2
3
4
- 再次运行 `wsl --install`。

### 2. 清除 Windows Update 缓存
- 停止 Windows Update 服务：

net stop wuauserv

1
2
- 删除 `C:\Windows\SoftwareDistribution` 文件夹中的所有内容。
- 重启服务：

net start wuauserv

1
2
3
4
5
6
7
8
9
- 重新尝试安装 WSL。

### 3. 安装最新 Windows 更新
- 打开 **设置 > Windows 更新**，安装所有待处理的更新。
- 重启系统后再次运行 `wsl --install`。

### 4. 手动安装 WSL 更新包
- 从 [Microsoft WSL GitHub](https://github.com/microsoft/WSL) 下载最新的 `.msixbundle` 文件。
- 以管理员身份打开 PowerShell，运行：

Add-AppxPackage .\path\to\wsl_update_x64.msixbundle

1
2
3
4
- 验证安装：`wsl --status`。

### 5. 检查系统文件
- 以管理员身份运行：

sfc /scannow

1
- 如果问题未解决，继续运行：

DISM /Online /Cleanup-Image /RestoreHealth

1
2
3
4
5
- 重启后重新尝试安装。

## 步骤 4：安装其他 Linux 发行版（可选）
1. 打开 **Microsoft Store**，搜索并安装其他 Linux 发行版（如 Debian、Kali Linux）。
2. 或者使用命令安装：

wsl –install -d <发行版名称>

示例：wsl --install -d Debian。

常见问题

  • WSL 命令无响应：确保 WSL 已正确启用且系统已重启。
  • 错误 0x80070003：检查磁盘空间或重新下载 WSL 更新包。
  • 无法访问 Linux 文件：在文件资源管理器中，Linux 文件位于 \\wsl$\<发行版名称>。

结论

通过以上步骤，你应该能够在 Windows 上成功安装和配置 WSL，并解决错误 0x8024001e。如果问题仍未解决，请运行 wsl --status 和 wsl --version，并检查详细错误信息。

如需更多帮助，请参考 Microsoft WSL 官方文档。