必须开启硬件虚拟化并正确配置WSL2，否则Docker Desktop无法启动；依次启用Windows子系统与虚拟机平台、安装WSL2、安装Docker Desktop并勾选WSL2引擎、启用WSL集成，最后用docker run hello-world验证成功。
要在Windows上让Docker Desktop真正跑起来且性能稳定，必须确保WSL2后端引擎启用并正确绑定，否则容器启动失败、镜像拉取卡死、甚至Docker图标在任务栏灰显都是常见结果。
检查并开启硬件虚拟化支持
这是所有后续操作的前提，跳过将导致WSL2安装中途报错或Docker无法启动。
按下 Ctrl + Shift + Esc 打开任务管理器 → 切换到“性能”选项卡 → 查看右下角“虚拟化”状态。若显示“已禁用”，需重启电脑进入BIOS/UEFI，找到 Intel VT-x（Intel CPU）或 AMD-V（AMD CPU）选项并设为 Enabled，保存退出。
这一步不可跳过，【未开启虚拟化时执行wsl --install会静默失败，后续所有步骤都无效】。
安装并配置WSL2子系统
推荐使用 PowerShell（管理员）一键部署，兼容 Win10 2004+ 和 Win11 全版本，家庭版也完全支持。
第一步：以管理员身份运行 PowerShell（右键「开始」→ 选择「终端（管理员）」或「Windows PowerShell（管理员）」）。
第二步：依次执行以下两条命令，每条执行完无报错再运行下一条：
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
第三步：重启电脑。重启后再次以管理员身份打开 PowerShell，运行：wsl --install。该命令会自动下载并安装 WSL2 内核更新包 + 默认 Ubuntu 发行版（如需指定版本，可用 wsl --install -d Ubuntu-22.04）。
Docker Hub (hub.docker.com)。此技能适用于所有 Docker Hub 操作，包括读取、创建、更新和删除数据。只要任务涉及 Docker Hub，就使用此技能。
安装完成后，系统会提示“请重启以完成安装”，务必重启。重启后打开终端输入 wsl -l -v，确认输出中 NAME 列为 Ubuntu（或你选的发行版），STATE 为 Running，VERSION 为 2。
下载并安装Docker Desktop
访问 Docker 官网（https://www.docker.com/products/docker-desktop/）下载最新 Windows 安装包（截至2026年11月，推荐 v4.30 或更高版本）。
双击运行 DockerDesktop Installer.exe，安装向导中必须勾选两项：
✓ Use WSL2 based engine
✓ Add Docker CLI to system PATH
不勾选“Create desktop shortcut”不影响功能，可按需取消。
安装完成后不要立即启动，先确保 WSL2 已就绪（即上一步 wsl -l -v 显示 Running）。
启用WSL2集成并验证引擎状态
首次启动 Docker Desktop 后，它可能仍默认使用 Hyper-V 后端，即使系统已装 WSL2，也必须手动切换。
方法一（图形界面设置）：
右键任务栏 Docker 图标 → Settings → General → 勾选 Use the WSL 2 based engine → 点击 Apply & Restart。
方法二（快速生效）：
启动 Docker Desktop 后，点击右上角齿轮图标进入 Settings → Resources → WSL Integration → 开启 Enable integration with my default WSL distro，并确保你安装的发行版（如 Ubuntu）右侧开关为绿色。
验证是否成功：打开 PowerShell，执行 docker run hello-world。若输出包含 “Hello from Docker!” 且末尾有 “This message shows that your installation appears to be working correctly.”，说明 WSL2 引擎已激活并正常工作。
