Docker Desktop启动失败解决:解决方法

必须开启BIOS虚拟化、启用Windows“虚拟机平台”和“WSL”，清理Docker WSL数据目录，重置Docker配置并保留镜像，禁用Hyper-V与Windows Sandbox——六步闭环解决Docker Desktop启动卡死或报错问题。

你在Windows上双击Docker Desktop图标，界面卡在“Starting the Docker engine”或直接弹出“Virtualization support not detected”报错，任务栏图标闪一下就消失，命令行执行docker info返回500错误——这不是安装包坏了，而是WSL2、虚拟化开关、系统功能三者之间出现了断连。

确认硬件虚拟化已开启并被Windows识别

这是所有后续操作的前提，跳过这步等于在没通电的插座上插电器。重启电脑，在开机自检画面出现时猛按F2（联想/华硕常见）或Del（戴尔/惠普常见），进入BIOS设置界面。

找到Advanced → CPU Configuration（或Security → Virtualization Support），将Intel VT-x（Intel CPU）或SVM Mode（AMD CPU）设为Enabled，按F10保存退出。

进系统后按Ctrl+Shift+Esc打开任务管理器→性能→CPU，右下角必须显示【虚拟化：已启用】。如果这里写“已禁用”，说明BIOS设置没生效，需重新进BIOS核对保存动作是否完成。

启用Windows底层虚拟化支持功能

即使CPU开了虚拟化，Windows默认也不启用相关子系统。必须手动激活两个核心组件：

第一步：按Win+R输入optionalfeatures.exe回车，勾选“虚拟机平台”和“Windows Subsystem for Linux”，点击确定。

第二步：系统提示需要重启，必须立即重启——【不重启，这两项功能不会真正加载】。

重启后再次打开任务管理器确认“虚拟化”状态，同时打开PowerShell（无需管理员权限）运行wsl --list --verbose，确保至少有一个发行版显示VERSION为2。

清理WSL2残留状态与Docker锁文件

异常退出会让WSL2数据目录留下未释放的socket和.lock文件，Docker Desktop启动时会因端口占用或挂载失败直接中止。

右键任务栏Docker图标→Quit Docker Desktop，彻底退出进程。

打开文件资源管理器，地址栏粘贴%LOCALAPPDATA%Dockerwsldata，删除该目录下全部内容。

同级路径下的distro文件夹也一并清空（若存在）。这一步会清除WSL2中Docker专用发行版，但不会影响你手动安装的Ubuntu等其他发行版。

重置Docker Desktop配置并保留镜像

用户配置损坏是卡在启动界面的高频原因，重置能绕过所有损坏的JSON配置，且默认保留你已拉取的镜像和创建的容器。

右键任务栏Docker图标→Troubleshoot→Reset to factory defaults。

弹窗中勾选【Keep my images and containers】，点击Reset，等待进度条走完。

重置完成后直接双击桌面图标启动，不要手动打开WSL终端或运行任何docker命令。

禁用Hyper-V与Windows Sandbox冲突项

Hyper-V和WSL2共用同一套虚拟化句柄，家庭版Windows强行启用Hyper-V会导致句柄争抢，Docker Engine拿不到资源就会无限转圈。

方法一：控制面板→程序→启用或关闭Windows功能，取消勾选“Hyper-V”和“Windows Sandbox”，仅保留“Windows Subsystem for Linux”。

方法二：以管理员身份运行PowerShell，执行：dism.exe /online /disable-feature /featurename:Microsoft-Hyper-V /norestart，再执行dism.exe /online /disable-feature /featurename:Containers /norestart。

执行完毕后必须重启电脑，否则禁用不生效。