在安装 Docker Desktop 时遇到这个问题,是因为 Docker Desktop 依赖 Windows Subsystem for Linux (WSL) 2 提供的轻量级虚拟化环境,而你当前的 WSL 版本过旧(可能是 WSL 1 或未更新的 WSL 2 内核),无法满足 Docker Desktop 的运行要求。
具体原因可能包括:
- WSL 未安装或版本过低:系统中未启用 WSL 功能,或安装的是旧版 WSL 1(Docker Desktop 需要 WSL 2);
- WSL 2 内核未更新:即使已安装 WSL 2,其内核组件可能未升级到最新版本;
- 虚拟化功能未启用:Windows 未开启 Hypervisor Platform 或相关虚拟化支持(如 Intel VT-x/AMD-V)。
解决方法需先通过 wsl --update 命令更新 WSL 内核,确保启用 WSL 2 并配置为 Docker Desktop 的默认后端。若问题持续,需检查 Windows 版本(需 ≥19041)、启用 Hyper-V 及 WSL 功能,并安装最新 WSL 2 内核更新包。

一、先确认 Windows 版本是否支持 WSL 2
WSL 2 需要 Windows 10 版本 2004(内部版本 19041)或更高,或 Windows 11。
- 按
Win + R,输入winver→ 查看弹出窗口中的版本号(如'版本 22H2 内部版本 22621.xxx')。 - 如果版本低于 19041,需先通过 Windows Update 升级系统(设置 → 更新和安全 → Windows Update)。
二、启用 WSL 和虚拟机平台功能
- 以管理员身份打开 PowerShell(右键开始菜单 → 选择'Windows PowerShell (管理员)')。
- 重启电脑 使功能生效。
运行以下命令启用 WSL 和虚拟机平台(两条命令需依次执行):
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
三、更新 WSL 至最新版本(关键步骤)
方法 1:自动更新(推荐) 以管理员身份打开 PowerShell,运行:
wsl --update
该命令会自动下载并安装最新 WSL 内核。
方法 2:手动安装内核更新包 如果自动更新失败,可手动下载官方内核包:
- 下载地址:WSL2 Linux 内核更新包(x64 版本)
- 下载后双击安装,按提示完成操作。
四、将 WSL 默认版本设为 2
- 验证版本:运行
wsl -l -v,若已安装 Linux 发行版(如 Ubuntu),其'VERSION'列应显示为2。 - 虚拟化未启用:进入 BIOS/UEFI(开机时按 F2/F10/Del 等键,不同主板不同),找到'虚拟化技术'(Intel VT-x/AMD-V)并启用。


