目录前言环境说明架构原理第一步启用 Windows 虚拟化功能第二步修复 Hypervisor 启动配置第三步安装 WSL 2 与 Ubuntu第四步启动 Docker Desktop第五步验证安装常见问题总结前言Docker 是目前最流行的容器化平台但其底层依赖 Linux 内核特性cgroups和namespace。在 Windows 11 家庭版上运行 Docker需要先通过 WSL 2Windows Subsystem for Linux 2提供一个真实的 Linux 内核环境。本文记录完整的配置排障过程。环境说明项目版本操作系统Windows 11 家庭版HomeDocker Desktop4.66.1Docker Engine29.3.1架构原理Windows 上运行 Docker 的调用链应用程序 ↓ Docker DesktopWindows 管理界面 ↓ WSL 2真实 Linux 内核 ↓ Hyper-V 虚拟机监控程序 ↓ Windows 硬件WSL 2 运行微软维护的真实 Linux 内核而非模拟层因此性能接近原生 LinuxDocker 兼容性完整。第一步启用 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 启动项。QWSL 2 和 WSL 1 有什么区别AWSL 1 通过转译层模拟 Linux 系统调用WSL 2 运行真实 Linux 内核基于 Hyper-V 轻量级虚拟机性能更好Docker 兼容性完整。总结Windows 11 家庭版安装 Docker Desktop 的核心逻辑Docker 依赖 Linux 内核 → WSL 2 提供真实 Linux 内核 → WSL 2 需要 Hyper-V 支持 → 家庭版需手动配置hypervisorlaunchtype理解这条链路排查问题就变得清晰直接。