Windows上Docker Desktop启动后窗口空白，最常见原因是WSL2未真正启动或状态异常，需依次清理注册表残留、重置WSL2（确保发行版为v2）、再静默重装。
Windows 上 Docker Desktop 启动后窗口空白，不是界面渲染失败，而是底层依赖未就绪导致 GUI 进程提前挂起——最常见原因是 WSL2 服务未真正启动或状态异常，其次是安装过程被安全软件拦截、注册表残留干扰 UI 初始化。
检查 wsl --list --verbose 是否显示 VERSION=2
空白窗口往往发生在 Docker Desktop 尝试连接 WSL2 分发版时失败。必须确认 WSL2 不仅已启用，而且至少有一个分发版被正确设为 v2：
- 以管理员身份打开 PowerShell，执行
wsl --list --verbose - 若列表为空，运行
wsl --install安装默认发行版（如 Ubuntu） - 若存在发行版但 VERSION 列显示
1，执行wsl --set-version 2（例如wsl --set-version Ubuntu-22.04 2） - 执行完后必须重启电脑，否则
wsl --shutdown无法彻底重置状态
清理注册表残留和安装器缓存
卸载不干净会导致新安装程序读取错误配置，直接跳过 UI 初始化阶段，表现为点击图标后无反应或白屏：
- 用
regedit删除以下两个路径（若存在）：HKEY_CURRENT_USER\Software\Docker Inc.和HKEY_LOCAL_MACHINE\SOFTWARE\Docker Inc. - 删除安装器临时目录：
%TEMP%\DockerInstaller和%LOCALAPPDATA%\Docker - 不要手动删
C:\Program Files\Docker—— 安装器会自动覆盖，但残留注册表项会让它误判为“升级”而非“全新安装”
绕过白屏：用静默命令行安装并强制指定后端
当图形安装器持续白屏，说明其 UI 渲染层已被阻断，但核心逻辑仍可执行。直接调用安装器的命令行接口可跳过所有前端校验：
- 以管理员身份打开 CMD，进入安装包所在目录
- 执行：
"Docker Desktop Installer.exe" install --quiet --accept-license --backend=wsl-2 --always-run-service --installation-dir="C:\Program Files\Docker" - 该命令不弹窗、不等待用户交互，全程后台运行（需 2–5 分钟），完成后任务栏会出现鲸鱼图标
- 如果提示“Access is denied”，说明杀毒软件正拦截进程创建——临时禁用 Windows Defender 实时保护再试
接显示器才能看到安装界面？别信这个玄学
有用户反馈“接上显示器才出现安装窗口”，实际是远程桌面（RDP）或无头环境（如服务器）下，Windows 的 UIPI（用户界面特权隔离）机制阻止了安装器创建窗口句柄。这不是 Docker 的 bug，而是 Windows 对无交互会话的限制：
- 在物理机或本地桌面环境下，无需外接显示器
- 若你在虚拟机或远程服务器上操作，改用
--quiet静默安装是最可靠方案 - 强行启用“远程桌面服务”或修改
winlogon注册表来绕过 UIPI，风险远大于收益，不建议尝试
真正卡住白屏的，90% 是 WSL2 状态 + 注册表残留 + 安全软件三者叠加的结果。单独修某一项可能无效，必须按顺序清注册表 → 重置 WSL2 → 静默重装，缺一不可。尤其注意：wsl --shutdown 后一定要等 10 秒再启动 Docker Desktop，否则 WSL2 内核模块加载不全，GUI 进程会因超时直接退出。
