启用及配置WSL2

在使用 WSL Dashboard 之前，您的 Windows 系统必须正确启用并配置好 WSL 2 环境。本章节将指导您完成必要的基础设置。

1. 检查系统要求

WSL 2 对 Windows 版本有最低要求。请按下 Win + R，输入 winver 检查您的版本：

Windows 10: 版本 1903 或更高，且内部版本 (Build) 需为 18362 或更高。
Windows 11: 所有版本均支持。

IMPORTANT

如果您的版本过低，请先通过“Windows 更新”升级您的系统。

2. 开启硬件虚拟化

WSL 2 基于虚拟化技术运行，因此必须在主板 BIOS/UEFI 中启用 虚拟化技术 (Virtualization Technology)。

检查方法: 打开“任务管理器” -> “性能”选项卡 -> “CPU”。
查看状态: 确认右下角的“虚拟化”状态显示为 “已启用”。
开启方式: 若未启用，您需要重启电脑进入 BIOS/UEFI 设置，找到类似 Intel VT-x 或 AMD-V 的选项并将其设为 Enabled。

3. 启用 Windows 相关功能

您需要开启 Windows 的“适用于 Linux 的 Windows 子系统”和“虚拟机平台”功能。

方法 A：通过图形界面 (推荐)

按下 Win + S，搜索并打开 “启用或关闭 Windows 功能”。
勾选以下两项：
- 适用于 Linux 的 Windows 子系统 (Windows Subsystem for Linux)
- 虚拟机平台 (Virtual Machine Platform)
点击“确定”，并在提示时重启电脑。

方法 B：通过命令行 (管理员权限)

以管理员身份运行 PowerShell 并执行以下命令：

powershell

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

# 启用虚拟机平台
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

执行完毕后，请手动重启电脑。

4. 安装/更新 WSL 内核

现代版本的 Windows 可以通过 Microsoft Store 获取 WSL 更新。

下载地址: Microsoft Store - Windows Subsystem for Linux
手动下载: 如果无法使用商店，可以从 WSL GitHub Releases 下载最新的 .msixbundle 或 .msi 安装包进行离线安装。

5. 设置 WSL 2 为默认版本

为了确保新安装的发行版默认使用 WSL 2，请在终端执行：

powershell

wsl --set-default-version 2

常见问题

错误 0x80370102: 通常是因为 BIOS 中未开启虚拟化，或者 Hyper-V 存在冲突。
WSL 1 与 WSL 2 切换: 您可以使用 wsl --set-version <分发版名称> 2 将现有的 WSL 1 实例升级到 WSL 2。

启用及配置WSL2 ​

1. 检查系统要求 ​

2. 开启硬件虚拟化 ​

3. 启用 Windows 相关功能 ​

方法 A：通过图形界面 (推荐) ​

方法 B：通过命令行 (管理员权限) ​

4. 安装/更新 WSL 内核 ​

5. 设置 WSL 2 为默认版本 ​

常见问题 ​