目录
[第一步：启用 Windows 虚拟化功能](#第一步：启用 Windows 虚拟化功能)
[第二步：修复 Hypervisor 启动配置](#第二步：修复 Hypervisor 启动配置)
[第三步：安装 WSL 2 与 Ubuntu](#第三步：安装 WSL 2 与 Ubuntu)
[第四步：启动 Docker Desktop](#第四步：启动 Docker Desktop)
前言
Docker 是目前最流行的容器化平台，但其底层依赖 Linux 内核特性（cgroups 和 namespace）。在 Windows 11 家庭版上运行 Docker，需要先通过 WSL 2（Windows Subsystem for Linux 2）提供一个真实的 Linux 内核环境。本文记录完整的配置排障过程。
环境说明
| 项目 | 版本 |
|---|---|
| 操作系统 | Windows 11 家庭版（Home） |
| Docker Desktop | 4.66.1 |
| Docker Engine | 29.3.1 |
架构原理
Windows 上运行 Docker 的调用链：
应用程序
↓
Docker Desktop（Windows 管理界面）
↓
WSL 2（真实 Linux 内核）
↓
Hyper-V 虚拟机监控程序
↓
Windows 硬件WSL 2 运行微软维护的真实 Linux 内核，而非模拟层，因此性能接近原生 Linux，Docker 兼容性完整。
第一步：启用 Windows 虚拟化功能
以管理员身份打开 PowerShell，启用"虚拟机平台"功能（WSL 2 的必要前提）：
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart第二步：修复 Hypervisor 启动配置
问题现象： 虚拟机平台已启用，但 bcdedit 输出中缺少 hypervisorlaunchtype 项，导致 Hyper-V 未随 Windows 启动，WSL 2 无法正常运行。
以管理员身份运行以下命令，将 hypervisor 设为自动启动：
bcdedit /set hypervisorlaunchtype auto执行成功后显示：操作成功完成。
然后重启电脑使配置生效。
说明： Windows 11 家庭版不带完整的 Hyper-V 管理界面，需要手动通过
bcdedit配置此项，这是家庭版与专业版配置的主要差异。
第三步：安装 WSL 2 与 Ubuntu
重启后，以管理员身份运行：
wsl --install此命令自动下载并安装 Ubuntu 发行版。安装完成后需要创建 Linux 用户账户：
-
用户名规则： 小写字母或下划线开头，可含小写字母、数字、下划线、连字符
-
密码输入时屏幕不显示字符，属于正常的 Linux 安全机制
注意： 若出现
NAT 模式下的 WSL 不支持 localhost 代理提示，为代理软件兼容性提示，不影响使用。
第四步：启动 Docker Desktop
完成以上步骤后打开 Docker Desktop，界面应正常启动，不再报虚拟化相关错误。
第五步：验证安装
打开 PowerShell 或 CMD，运行以下命令验证：
docker version
docker run hello-world若 hello-world 容器成功运行并输出以下内容，说明环境配置完全成功：
Hello from Docker!
This message shows that your installation appears to be working correctly.常见问题
Q：为什么 Windows 家庭版比专业版配置更复杂？
A：专业版内置完整 Hyper-V 管理工具，家庭版需要手动通过 bcdedit 配置 hypervisor 启动项。
Q：WSL 2 和 WSL 1 有什么区别？
A：WSL 1 通过转译层模拟 Linux 系统调用，WSL 2 运行真实 Linux 内核（基于 Hyper-V 轻量级虚拟机），性能更好，Docker 兼容性完整。
总结
Windows 11 家庭版安装 Docker Desktop 的核心逻辑：
Docker 依赖 Linux 内核 → WSL 2 提供真实 Linux 内核 → WSL 2 需要 Hyper-V 支持 → 家庭版需手动配置 hypervisorlaunchtype
理解这条链路，排查问题就变得清晰直接。