Docker Desktop 启动失败主因是专用分发版 docker-desktop 未注册或状态异常，而非用户安装的 Ubuntu 等发行版问题；需通过 wsl --shutdown、清理残留数据目录并重启 Docker Desktop 触发自动重建。
直接说结论：Docker Desktop 找不到 WSL 发行版，90% 是因为 docker-desktop 这个专用分发版根本没注册进系统，而不是你本地装的 Ubuntu 或 Debian 没起作用。
为什么 wsl --list 看得见 Ubuntu，但 Docker Desktop 启动失败？
Docker Desktop 不依赖你手动安装的发行版（比如 Ubuntu），它自己需要两个专属分发版：docker-desktop 和 docker-desktop-data。它们由 Docker Desktop 安装过程自动注册，不显示在 Microsoft Store 里，也不出现在你手动执行 wsl --install 的流程中。
常见错误现象：
-
wsl --list --verbose输出里压根没有docker-desktop这一行 - 有这一行，但
STATE是Uninstalling或Stopped，且wsl -t docker-desktop报错WSL_E_DISTRO_NOT_FOUND - Docker Desktop 设置页里「Use the WSL 2 based engine」开关灰掉，点不了
wsl --unregister docker-desktop 之前必须确认的事
别急着删。先确认当前状态是否真的可安全清理：
- 运行
wsl --list --verbose，如果docker-desktop显示Uninstalling，说明上次卸载卡住了，此时直接wsl --unregister会失败 - 运行
wsl --shutdown再试一次wsl --list --verbose，看状态是否变成Stopped—— 只有Stopped或Running才能被正常注销 - 若仍报
WSL_E_DISTRO_NOT_FOUND，说明注册表项已损坏但残留配置还在，这时要进 PowerShell 管理员模式手动清理：Remove-Item HKCU:\Software\Microsoft\Windows\CurrentVersion\Lxss\{...} -Recurse（需先用Get-ChildItem HKCU:\Software\Microsoft\Windows\CurrentVersion\Lxss\找到对应 GUID）
强制重建 docker-desktop 分发版的最小可行步骤
不是重装 Docker Desktop，也不是重装 WSL，而是让 Docker Desktop 自己重新生成那两个关键分发版：
- 确保 WSL 2 已就绪：
wsl --update+wsl --set-default-version 2，并重启过系统 - 关闭 Docker Desktop，右键任务栏图标 → Quit Docker Desktop
- 管理员 PowerShell 中执行：
wsl --shutdown，再删掉残留数据目录（谨慎！）：Remove-Item "$env:LOCALAPPDATA\Docker\wsl\data\*" -Recurse -Force - 重启 Docker Desktop —— 它会检测到缺失的分发版，自动触发初始化流程，下载并注册
docker-desktop和docker-desktop-data - 等待约 1–3 分钟，观察日志面板是否出现
Starting distro docker-desktop...，成功后wsl -l -v就能看到两个分发版都变成Running
容易被忽略的磁盘与权限陷阱
即使命令都跑通，也可能卡在最后一步：
-
docker-desktop-data默认存放在%LOCALAPPDATA%\Docker\wsl\data，如果该路径所在磁盘剩余空间 wsl -l -v 里只显示docker-desktop，缺-data分发版 - 杀毒软件（尤其是 Windows Defender 实时防护）可能拦截
wsl.exe对 VHDX 文件的写入，表现为分发版反复卡在Starting状态，需临时禁用或添加排除路径 - 如果你改过
%USERPROFILE%路径（比如重定向到 D:\Users），Docker Desktop 仍会尝试往默认位置写，导致权限拒绝，此时需在 Docker Desktop Settings → Resources → WSL Integration 中关闭所有发行版集成，再单独启用并指定路径
