Windows 安装 Docker Desktop 详细指南
一、为什么选择 Docker？
- ：一次构建，处处运行
PowerShell
Windows 安装 Docker Desktop 详细指南
在 Windows 系统上安装 Docker Desktop 的完整流程，包括启用 Hyper-V 和 WSL 2 虚拟化组件、更新内核、下载安装包及配置国内镜像加速器。内容涵盖版本选择、命令执行细节、常见问题排查及验证方法，帮助用户快速完成容器化环境部署。
在 Windows 系统上安装 Docker Desktop 的完整流程，包括启用 Hyper-V 和 WSL 2 虚拟化组件、更新内核、下载安装包及配置国内镜像加速器。内容涵盖版本选择、命令执行细节、常见问题排查及验证方法，帮助用户快速完成容器化环境部署。
| 版本 | 适用设备 | 市场占有率 |
|---|---|---|
| AMD64 | Intel/AMD 主流 CPU 的 Win10/11 | >99% |
| ARM64 | Surface Pro X 等 ARM 架构设备 | <1% |
💡 普通用户 99% 选 AMD64！
查看本机架构：设置 > 系统 > 关于→ 检查 '系统类型'
# 以管理员身份打开 PowerShell 执行以下命令
# 启用 Hyper-V 虚拟化平台
dism.exe /online /enable-feature /featurename:Microsoft-Hyper-V /all /norestart
# 启用 WSL 2 虚拟机平台
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
重启电脑生效！
这两条 PowerShell 命令是通过 dism.exe 工具启用 Windows 系统的两个核心虚拟化组件，为 Docker Desktop 运行容器提供底层支持。
dism.exe 是什么？dism（Deployment Image Servicing and Management，部署映像服务和管理工具）是 Windows 内置的系统维护工具，可用于启用/禁用系统功能、修复系统映像等。这里的 /online 参数表示操作当前正在运行的 Windows 系统（而非离线映像）。
/enable-feature：启用指定系统功能；/featurename:Microsoft-Hyper-V：目标功能是 Hyper-V（包含 Hyper-V 管理器、虚拟机监控程序等）；/all：启用该功能所有子组件（避免遗漏依赖）；/norestart：临时不重启系统（后续需手动重启生效）。/featurename:VirtualMachinePlatform：目标功能是 '虚拟机平台'（专门为 WSL 2 设计的轻量级虚拟化层，基于 Hyper-V 技术但更精简）；/all 启用所有子功能，/norestart 暂不重启）。VirtualMachinePlatform 正是 WSL 2 运行的必要基础——没有它，WSL 2 无法启动，Docker 也就无法通过 WSL 2 高效运行 Linux 容器。简单说：Docker 在 Windows 上的运行依赖'虚拟化环境'，而这两个组件共同构成了虚拟化的基础：
现在 Docker Desktop 安装时会自动检测并优先使用 WSL 2（需 VirtualMachinePlatform 支持），若 WSL 2 不可用才会回退到 Hyper-V。因此，启用这两个组件是为了确保 Docker 有可用的虚拟化环境，避免'缺少依赖'导致安装失败。
/norestart 只是暂时不重启，最终必须重启）。这两条命令的本质是：为 Docker 在 Windows 上运行'铺路'——启用系统自带的虚拟化组件，让 Docker 能创建容器运行所需的'沙箱环境'。
普通用户只需按步骤执行，重启后即可继续安装 Docker Desktop~
重启后，在 cmd 中输入命令：wsl --status。
若输出中包含 默认版本：2 和 内核版本：…，说明 VirtualMachinePlatform 已生效（WSL 2 依赖它）。
![图片]
重启后，打开'服务'（services.msc），查找以下服务：
若状态为 '正在运行'，说明 Hyper-V 组件已生效（部分场景下可能按需启动，非必须一直运行）。
![图片]
👉 双击安装
若提示：您的系统已安装了更高版本的 Windows 子系统 Linux 更新。安装程序即将退出。
![图片]
执行：
wsl --set-default-version 2
![图片]
✅ 认准 'Download for Windows - AMD64' 按钮
![图片]
Docker Desktop Installer.exe![图片]
要理解 Docker Desktop 安装界面这三个选项的含义，我们可以逐个拆解：
意思是 '使用 WSL 2 替代 Hyper-V（推荐）'。
意思是 '允许此安装使用 Windows 容器'。
意思是 '在桌面添加快捷方式'。
非常直观：勾选后，Docker Desktop 的启动快捷方式会自动出现在电脑桌面，方便你后续一键打开程序～
简单总结：
![图片]
安装完成后桌面就会出现一个图标，双击。
![图片]
进入：
![图片]
点击接受，然后：
![图片]
使用 github 账号登录：
![图片]
这个提示的意思是：你的 Windows 子系统 for Linux (WSL) 版本太旧了，需要更新。
这个命令会自动下载并安装最新版本的 WSL。
![图片]
输入以下命令并按回车执行：
wsl --update
更新完成后，点击提示窗口中的 'Restart' 按钮，或手动重启电脑，使更新生效。
![图片]
简单来说：你的 WSL 该升级了，运行一下它给出的命令就行。 这是 Windows 系统组件的正常更新流程，按照提示操作即可。
docker --version # 输出示例：Docker version 24.0.7, build afdd53b
![图片]
docker run hello-world # 出现 "Hello from Docker!" 即成功！
![图片]
若长时间卡在'拉取中'或提示 pull access denied/network timeout，说明拉取出错，需排查以下问题：
Settings进入 Docker Engine 选项卡
![图片]
{
"registry-mirrors": [
"https://docker.mirrors.ustc.edu.cn",
"https://hub-mirror.c.163.com"
]
}
![图片]
Apply & RestartWSL 2 installation is incomplete解决方案：
wsl --updateDocker Desktop requires a newer WSL kernel解决方案： 升级 Windows 系统至 21H2 或更高版本
排查步骤：
netsh winsock reset 重置网络栈
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online