安装 Docker Desktop 时遇到'WSL needs updating'提示,通常意味着当前的 Windows Subsystem for Linux 环境不符合运行要求。Docker Desktop 强依赖 WSL 2 提供的轻量级虚拟化层,如果内核太老或功能未启用,就会卡在这里。
主要原因有三点:一是 WSL 功能未安装或停留在旧版;二是 WSL 2 内核组件未升级;三是系统层面的虚拟化支持(如 Intel VT-x/AMD-V)未开启。
别急,按下面步骤排查,基本都能解决。
一、确认系统版本是否达标
WSL 2 需要 Windows 10 版本 2004(内部版本 19041)或更高,或者直接使用 Windows 11。
按下 Win + R 键,输入 winver 回车,查看弹出的窗口。如果版本号低于 19041,请先通过 Windows Update 升级到最新。
二、更新 WSL 内核与默认版本
这是最关键的一步。我们需要用管理员权限运行命令来拉取最新的 WSL 内核。
-
打开 PowerShell 在开始菜单搜索 PowerShell,右键选择'以管理员身份运行'。
-
执行更新命令 在终端中输入以下命令并回车:
wsl --update等待下载完成,这会自动将 WSL 内核升级到最新版。
-
强制指定 WSL 2 为了确保 Docker 使用正确的后端,建议显式设置默认版本:
wsl --set-default-version 2
三、检查虚拟化功能
如果上述操作后依然报错,请检查 BIOS 或 UEFI 中是否开启了虚拟化技术(Intel VT-x 或 AMD-V),同时在 Windows 功能列表中确保勾选了'虚拟机平台'和'适用于 Linux 的 Windows 子系统'。
重启电脑后再次尝试启动 Docker Desktop,问题通常就能迎刃而解。

