WSL needs updatingYour version of Windows Subsystem for Linux (WSL) is too old.如何解决
安装 Docker Desktop 时出现该问题,核心原因是:Docker Desktop 运行依赖 Windows Subsystem for Linux (WSL) 2 提供的轻量级虚拟化环境,而你的系统当前的 WSL 环境不符合运行要求。具体诱因主要有这三点:
- WSL 功能未安装 / 版本过低:系统未启用 WSL 功能,或仅安装了旧版 WSL 1(Docker Desktop 硬性要求为 WSL 2 版本);
- WSL 2 内核未更新:即便已安装 WSL 2,其内核组件未升级至最新版本,无法适配 Docker 运行需求;
- 系统虚拟化功能未开启:Windows 未启用 Hypervisor Platform 虚拟化组件,也未开启主板层面的 Intel VT-x/AMD-V 虚拟化支持。
解决方式:优先通过 wsl --update 命令更新 WSL 内核版本,确保系统默认使用 WSL 2 并配置为 Docker Desktop 的运行后端;若问题依旧,需核对系统版本需 ≥ Windows 10 2004 (版本号≥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(右键开