安装 Docker Desktop 时遇到 "WSL 2 installation is incomplete" 的解决方法

安装 Docker Desktop 时遇到 "WSL 2 installation is incomplete" 的解决方法

如果在安装 Docker Desktop 时遇到 "WSL 2 installation is incomplete" 的错误消息，这意味着 Windows Subsystem for Linux 2 (WSL 2) 安装不完整。

当您的WSL 2安装不完整时，可以采取一些步骤来排查和解决问题：

1. 检查系统要求：确保您的系统符合运行WSL 2的要求。您需要使用Windows 10版本2004或更高版本，构建号为19041或更高。

2. 启用虚拟化：验证您的系统的BIOS设置中是否启用了虚拟化。WSL 2依赖虚拟化技术，因此必须启用虚拟化以使WSL 2正常运行。

3. 更新Windows：确保您的Windows操作系统是最新的。从Windows更新设置中安装任何待处理的更新。

4. 启用WSL功能：以管理员身份打开PowerShell，并运行以下命令以启用Windows子系统Linux功能：

   dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
   

   • 或者你可以输入：window + R，然后输入optionalfeatures 如下图所示：

• 然后可以进入Windows功能界面，并将适用于Linux的Windows子系统打上勾。

5. 启用虚拟机平台功能：在同一个PowerShell窗口中，运行以下命令以启用虚拟机平台功能：

   dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
   

6. 下载并安装WSL 2 Linux内核更新包：访问WSL 2 Linux内核更新页面（https://learn.microsoft.com/zh-cn/windows/wsl/install-manual#step-4---download-the-linux-kernel-update-package）

   • 具体可以直接使用这个链接下载WSL更新包：https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi，下载完之后安装它。

7. 将WSL 2设置为默认版本：打开PowerShell，并运行以下命令，将WSL 2设置为新安装的发行版的默认版本：

   wsl --set-default-version 2
   

8. 安装Linux发行版：打开Microsoft Store，搜索自己需要的Linux发行版，如Ubuntu，并安装它。按照屏幕上的说明完成安装。

9. 初始化和设置Linux发行版：就是设置用户名和密码。

10. 打开你的Docker就不会报错了。