Windows下Docker Desktop安装异常，Docker Engine无法启动求助

问题背景 #

按官方流程安装Docker Desktop for Windows x86_64版本，尝试WSL模式时因无WSL环境执行wsl --install后仍无法启动；切换Hyper-V模式、勾选「基于WSL的引擎」、重置设置均失败，Docker Desktop自动关闭；通过PowerShell命令启用/禁用Hyper-V后问题依旧。

分步解决方案 #

1. 彻底清理现有Docker及残留文件

• 卸载Docker Desktop：进入「设置→应用→应用和功能」，找到Docker Desktop完成卸载
• 删除残留目录：
  • C:\Program Files\Docker
  • C:\Users\<你的用户名>\.docker
  • C:\Users\<你的用户名>\AppData\Roaming\Docker
  • C:\Users\<你的用户名>\AppData\Local\Docker
• 清理WSL残留（若有）：

  wsl --unregister Ubuntu  # 替换为已安装的发行版名称
  wsl --shutdown
  

2. 重新配置WSL 2环境（优先推荐模式）

以管理员身份打开PowerShell，依次执行以下命令：

# 启用WSL组件
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
# 启用虚拟机平台组件
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

重启电脑后，设置WSL默认版本为2：

wsl --set-default-version 2

安装WSL发行版（以Ubuntu为例）：

wsl --install -d Ubuntu

完成发行版初始化（设置用户名和密码）。

3. 重新安装Docker Desktop

• 下载最新版Docker Desktop for Windows x86_64安装包
• 安装时仅勾选**「使用WSL而非Hyper-V（推荐）」**和「创建桌面快捷方式」，其余选项保持默认
• 安装完成后启动Docker Desktop，进入「设置→资源→WSL集成」，确保已启用刚安装的Ubuntu发行版，点击「应用并重启」

4. Hyper-V模式兜底排查（若WSL模式仍失败）

• 确认BIOS/UEFI虚拟化已启用：重启电脑进入BIOS/UEFI界面，开启Intel VT-x（AMD平台为AMD-V）和虚拟化相关选项
• 启用Hyper-V组件：

  dism.exe /Online /Enable-Feature /FeatureName:Microsoft-Hyper-V-All /All /LimitAccess /Restart
  

• 重启后打开Docker Desktop设置，切换为「使用Hyper-V」模式，取消勾选「使用基于WSL的引擎」，点击「应用并重启」

5. 日志定位精准问题

若以上步骤均无效，通过日志排查：

• 打开Docker Desktop，进入「故障排除→显示日志」
• 查看Docker Desktop.log或vmms.log（Hyper-V相关），搜索Failed to start、Hyper-V error等关键词，定位具体错误后针对性修复

内容的提问来源于stack exchange，提问作者Azhagu Surya