首先确认系统为Windows 11专业版，启用Hyper-V与WSL2功能，通过PowerShell命令强制开启组件，安装WSL2内核更新包并设为默认版本，清除旧版Docker残留配置及环境变量，最后配置国内镜像加速源解决拉取失败问题。
如果您尝试在 Windows 11 上安装或运行 Docker Desktop，但遇到安装失败、启动报错或功能异常等问题，这通常与系统版本、依赖组件或配置错误有关。以下是解决此问题的步骤：
本文运行环境：Dell XPS 13，Windows 11 专业版
一、检查并升级系统版本
Docker Desktop 官方要求使用 Windows 11 专业版、企业版或教育版，家庭版默认不支持 Hyper-V 和 WSL2 的完整功能，可能导致安装中断或无法启动。
1、按下 Win + R 键，输入 winver 并回车，查看当前系统版本类型。
2、如果显示为“家庭版”，需升级至专业版。可通过微软官方提供的多版本 ISO 镜像进行升级安装。
3、下载 Multi-Edition ISO 镜像后，使用工具创建启动盘并重启电脑，选择安装专业版。
4、完成安装后再次运行 winver 确认版本已更改为专业版。
二、启用必要的 Windows 功能
Docker Desktop 依赖 Hyper-V 和虚拟机平台等核心组件，若未启用则无法正常运行。
1、右键点击开始菜单，选择“应用和功能” > “可选功能” > “更多 Windows 功能”。
2、在弹出的窗口中勾选以下两项：Hyper-V、虚拟机平台 和 适用于 Linux 的 Windows 子系统。
3、点击确定后等待系统安装功能组件，完成后根据提示重启计算机。
三、通过命令行强制启用 WSL 与虚拟化支持
当图形界面无法正确启用功能时，可通过管理员权限的 PowerShell 命令强制开启相关服务。
1、以管理员身份打开 PowerShell（可在开始菜单搜索 PowerShell，右键选择“以管理员身份运行”）。
2、依次执行以下命令：
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
3、执行完毕后重启电脑，确保更改生效。
四、手动安装 WSL2 内核更新包
即使启用了 WSL 功能，缺少内核更新包也会导致 Docker 报错“WSL2 distribution launch failed”。
1、访问 Microsoft 官方 WSL 内核更新页面：https://aka.ms/wsl2kernel。
2、下载适用于 x64 系统的 wsl_update_x64.msi 更新包。
3、双击运行安装程序，按照向导完成安装过程。
4、安装完成后，在 PowerShell 中运行 wsl --set-default-version 2 将默认版本设为 WSL2。
五、清除残留配置文件与环境变量冲突
曾安装过 Docker Toolbox 或旧版 Docker Desktop 的用户，可能因残留配置导致新版本无法初始化。
1、关闭所有 Docker 相关进程，退出任务栏中的 Docker 图标。
2、删除用户目录下的隐藏文件夹：C:\Users\您的用户名\.docker。
3、按 Win + R 输入 sysdm.cpl 打开系统属性，进入“高级”选项卡下的“环境变量”。
4、检查用户变量和系统变量中是否存在指向旧 Docker 虚拟机 IP（如 192.168.99.100）的条目，若有则删除。
六、配置国内镜像加速源解决拉取失败
在执行 docker pull 时出现超时或连接被取消错误，通常是由于网络策略限制了对官方镜像仓库的访问。
1、打开 Docker Desktop 设置界面，进入“Docker Engine”配置项。
2、在 JSON 配置中添加 registry-mirrors 字段，使用可靠的国内镜像服务：
"registry-mirrors": ["https://mirror.baidubce.com", "https://docker.m.daocloud.io", "https://hub-mirror.c.163.com"]
3、点击应用并重启 Docker 服务，之后尝试重新拉取镜像。
