“WSL 2 installation is incomplete”错误表明WSL2内核缺失、默认版本未设为2或发行版未运行;需依次启用Windows功能、安装官方内核包、执行wsl --set-default-version 2、安装Ubuntu-22.04发行版,并终止docker-desktop相关WSL实例后重启。

Win11安装Docker Desktop后启动失败,弹出“WSL 2 installation is incomplete”错误提示,说明系统已识别Docker Desktop依赖WSL2,但WSL2的内核、版本配置或运行状态存在硬性缺失,不是简单重装Docker就能解决的问题。
确认WSL当前真实状态
以管理员身份打开PowerShell,执行:
wsl --list --verbose
如果命令报错“wsl不是内部或外部命令”,说明WSL功能根本未启用;如果返回空列表或所有发行版VERSION显示为1,则证明WSL2尚未安装或未设为默认;如果显示VERSION为2但STATE为Stopped,需手动启动对应发行版。这一步不跳过,否则后续所有操作都在补漏。
强制启用WSL与虚拟机平台功能
在管理员PowerShell中依次执行:
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:Microsoft-VirtualMachinePlatform /all /norestart
【必须重启电脑】这两项Windows功能启用后不会立即生效,不重启会导致后续wsl --update始终失败,且Docker Desktop启动时仍判定环境不完整。
下载并安装WSL2 Linux内核更新包
方法一:直接运行自动更新命令
wsl --update
若提示“与服务器的连接被重置”或超时失败,说明网络策略拦截或微软CDN访问异常,此时不能反复重试,应改用离线方式。
方法二:手动下载安装(推荐)
访问 https://aka.ms/wsl2kernel ,下载 wsl_update_x64.msi 文件,双击运行完成安装。该安装包仅含轻量级Linux内核,不附带任何发行版,专用于修复“WSL 2 installation incomplete”的底层缺失。
将WSL默认版本设为2并验证发行版
第一步:设置全局默认版本
wsl --set-default-version 2
第二步:检查是否已有发行版
wsl --list --verbose
第三步:若无发行版,安装一个最小可用环境
wsl --install -d Ubuntu-22.04
Ubuntu-22.04是目前Docker Desktop兼容性最稳定的发行版,比Ubuntu-24.04更少出现cgroup v2冲突问题。安装过程会自动下载、解压、初始化,完成后执行wsl -d Ubuntu-22.04进入终端,输入exit退出即可。
重启Docker Desktop并绕过首次初始化卡死
关闭所有Docker Desktop进程(任务管理器中结束docker-desktop、com.docker.backend等)。
右键开始菜单→“Windows Terminal(管理员)”→输入:
wsl -t docker-desktop → 回车
wsl -t docker-desktop-data → 回车
这两条命令强制终止Docker Desktop自建的两个关键WSL发行版,清除其可能存在的挂起状态。之后再双击启动Docker Desktop图标,它会重新初始化,不再卡在“Starting backend…”无限转圈。


















