在 windows 上安装并运行 docker desktop 需满足系统要求并启用 wsl2:先确认 windows 10/11 版本及版本号,启用 wsl2 和虚拟机平台功能,重启后安装内核更新包、设默认版本为 2 并安装 linux 发行版;再下载 docker desktop 安装包,勾选“use the wsl 2 based engine”,安装后运行 docker --version 和 docker run hello-world 验证。

在 Windows 上安装并运行 Docker Desktop,核心前提是系统满足要求,并正确启用 WSL2 或 Hyper-V(推荐 WSL2)。整个过程不复杂,但几个关键步骤容易出错,下面分步说明。
确认系统要求和前置条件
Docker Desktop for Windows 仅支持 Windows 10/11 专业版、企业版或教育版(家庭版需额外启用 WSL2)。必须满足以下任一组合:
- Windows 10 版本 2004(Build 19041)或更高 + WSL2 启用
- Windows 11 全版本(默认支持 WSL2)
- 旧系统(如 Win10 1809)可尝试 Hyper-V 方式,但已不推荐,兼容性和性能较差
检查方法:打开 PowerShell(管理员),运行 wsl -l -v。若提示未安装或无返回,需先安装 WSL2;若显示“WSL2 已安装”,继续下一步。
安装 WSL2(如尚未启用)
这是大多数用户卡住的第一步。操作顺序不能颠倒:
- 以管理员身份打开 PowerShell,依次执行:
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart - 重启电脑
- 下载并安装 WSL2 Linux 内核更新包
- 设置 WSL2 为默认版本:wsl --set-default-version 2
- 安装一个 Linux 发行版(如 Ubuntu)从 Microsoft Store,首次启动会自动初始化
下载并安装 Docker Desktop
前往 Docker 官网下载页面,选择 Windows 版本(.exe 安装包)。注意:
- 无需手动下载 Docker Engine 或 CLI,Desktop 已集成
- 安装时勾选 “Use the WSL 2 based engine”(务必勾选!)
- 可选勾选 “Add shortcut to desktop” 和 “Start Docker Desktop when you log in”
- 安装完成后,系统可能提示重启 WSL:运行 wsl --shutdown 再重启 Docker Desktop
验证安装并运行首个容器
安装完成并启动 Docker Desktop 后(任务栏右下角出现鲸鱼图标),打开终端(PowerShell、CMD 或 VS Code 终端):
- 运行 docker --version 确认 CLI 可用
- 运行 docker run hello-world —— 这会自动拉取镜像、启动容器并输出欢迎信息
- 若提示 “Cannot connect to the Docker daemon”,说明后台服务未就绪,等待 10–20 秒再试,或点击任务栏图标 → “Restart Docker Desktop”
- 想查看正在运行的容器?用 docker ps;想看所有容器(含已退出)?加 -a 参数
至此,Docker Desktop 已在 Windows 上正常运行,后续可直接使用 docker 命令或通过桌面 UI 管理镜像、容器和设置。










