Windows安装Docker Desktop时提示“WSL2未启用”怎么办？

Question

在Windows上安装Docker Desktop时提示“WSL2未启用”，是常见兼容性问题。Docker Desktop（v2.3.0.0+）默认依赖WSL2后端，若系统未启用WSL2或内核未更新，安装将失败或运行异常。典型表现包括：安装向导卡在“Enabling WSL”、启动时报错“WSL2 is not installed”或“Please enable WSL2 in Windows Features”。根本原因通常为：① Windows版本过低（需Win10 2004+/Build 19041+ 或 Win11）；② BIOS中虚拟化（VT-x/AMD-V）未开启；③ Windows功能中“Windows Subsystem for Linux”和“Virtual Machine Platform”未启用；④ WSL2内核组件未手动下载安装；⑤ 用户账户控制（UAC）或组策略限制了服务启动。该问题非Docker配置错误，而是底层运行环境缺失，需按顺序检查系统要求、启用功能、安装内核并设为默认版本。跳过WSL2直接使用Hyper-V模式仅适用于专业版/企业版，且已逐步被弃用。

Answer 1

```html

一、现象识别：典型错误表现与日志线索

安装 Docker Desktop v2.3.0.0+ 时，用户常遭遇以下可复现的 UI/CLI 行为：

• 安装向导卡在 Enabling WSL... 步骤超过 3 分钟无响应；
• 首次启动后弹出红色警告：WSL2 is not installed 或 Please enable WSL2 in Windows Features；
• 命令行执行 wsl -l -v 返回空或报错 Invalid argument；
• Docker Desktop 设置页中 General → Use the WSL 2 based engine 灰显不可勾选。

二、系统基线核查：Windows 版本与硬件虚拟化就绪性

WSL2 强依赖操作系统内核能力与 CPU 硬件支持。需按序验证：

检查项	合规要求	验证命令
Windows 版本	Win10 2004 (Build 19041) 或更高 / Win11 全版本	winver 或 systeminfo | findstr "OS Version"
CPU 虚拟化状态	BIOS 中 VT-x（Intel）或 AMD-V（AMD）必须启用	systeminfo | findstr "Hyper-V Requirements"（关注 VM Monitor Mode Extensions: Yes）

三、功能启用：Windows 功能模块的原子级激活

WSL2 非单一功能，而是两个独立 Windows Feature 的协同组合：

1. Windows Subsystem for Linux（提供用户态兼容层）
2. Virtual Machine Platform（提供轻量级 Hyper-V 变体内核服务）

二者缺一不可，且必须以管理员权限启用：

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

四、内核补全：WSL2 Linux 内核更新包的手动注入

即使功能启用，Windows 默认不预装 WSL2 内核。官方内核更新包（wsl_update_x64.msi）需单独下载并安装：

• 下载地址：https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi
• 安装后执行：wsl --update --web-download（强制在线重拉最新内核）
• 设为默认版本：wsl --set-default-version 2

五、策略与权限深水区：UAC、组策略与服务依赖链

企业环境中常见隐性阻断点：

• UAC 级别过高：导致 LxssManager 服务无法以 SYSTEM 权限启动；
• 组策略禁用虚拟化服务：路径 Computer Configuration → Administrative Templates → System → Device Installation → Device Installation Restrictions 中禁止了内核驱动加载；
• 依赖服务未运行：检查 WslService、LxssManager、vmms（若启用了 Hyper-V）是否处于 Running 状态。

六、诊断流程图：结构化排障决策树

graph TD
  A[启动 Docker Desktop 失败] --> B{wsl -l -v 是否返回列表？}
  B -->|否| C[检查 Windows 版本 & BIOS VT]
  B -->|是| D[检查 wsl --status 输出]
  C --> E[启用 WSL/VM Platform + 重启]
  E --> F[下载安装 wsl_update_x64.msi]
  F --> G[wsl --set-default-version 2]
  D --> H[查看 Docker Desktop 日志： %APPDATA%\Docker\log.txt]
  G --> I[重启 LxssManager 服务]
  I --> J[验证 docker info | grep 'Default Runtime' == runc]

七、替代路径警示：Hyper-V 模式已进入维护末期

尽管 Windows Pro/Enterprise 用户可通过切换至 Hyper-V 后端绕过 WSL2 依赖（设置 → General → Use the Hyper-V backend），但该模式存在严重局限：

• Docker Desktop v4.18+ 已标记 Hyper-V 后端为 Deprecated；
• 不支持 WSL2 的跨发行版文件系统互通（如 Ubuntu ↔ Alpine 容器共享 /mnt/wsl）；
• 资源开销比 WSL2 高 30–45%，且无法利用 WSL2 的原生 systemd 支持（需手动启用）。

八、验证闭环：五步黄金确认法

1. wsl --list --verbose 显示至少一个发行版且 STATE=Stopped/Running，VERSION=2；
2. sc query LxssManager 返回 STATE = 4 RUNNING；
3. docker version --format '{{.Server.Version}}' 输出 ≥ 20.10.x；
4. docker run --rm hello-world 成功输出欢迎信息；
5. Docker Desktop 设置页中 Resources → WSL Integration 可勾选任意已安装的 WSL 发行版。

```