Docker Desktop + WSL2 完美安装指南 (Windows 10/11 小白图文教程)

Docker Desktop + WSL2 完美安装指南 (Windows 10/11 小白图文教程)

欢迎来到Windows安装Docker的详细教程！本文将手把手教你如何在Windows系统上通过Docker Desktop与WSL2搭建高效的Docker开发环境。即使你是零基础的小白，也能轻松完成安装。

一、准备工作

确保你的Windows版本满足要求：Windows 10 版本2004及以上（内部版本19041及以上）或Windows 11。同时需要在BIOS中开启虚拟化支持（VT-x/AMD-V）。

二、启用WSL2功能

以管理员身份打开PowerShell，执行以下命令启用WSL2功能并设置为默认版本：

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestartdism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestartwsl --set-default-version 2

完成后重启电脑。

三、安装Linux发行版（以Ubuntu为例）

打开Microsoft Store，搜索“Ubuntu”并安装（推荐Ubuntu 20.04 LTS或22.04 LTS）。安装后启动，等待初始化，并设置用户名和密码。或者使用命令一键安装：wsl --install -d Ubuntu。

四、安装Docker Desktop

访问Docker官网下载Docker Desktop for Windows。双击安装，在配置界面务必勾选“Use WSL 2 instead of Hyper-V”（推荐）。安装完成后重启系统。

五、配置Docker Desktop与WSL2集成

启动Docker Desktop，进入设置（Settings） → Resources → WSL Integration。开启“Enable integration with my default WSL distro”，并确保你安装的Ubuntu发行版被启用（开关打开）。点击Apply & Restart。

六、验证安装

打开WSL终端（Ubuntu），输入以下命令测试：

docker --versiondocker run hello-world

若看到Docker版本信息和Hello-World欢迎信息，则说明Docker Desktop与WSL2已完美运行，你的Docker开发环境搭建成功！

七、常见问题

• 问题：启动Docker时提示WSL2内核未更新 → 下载并安装WSL2内核更新包。
• 问题：docker命令找不到 → 确认Docker Desktop已启动，并在WSL终端中检查PATH。

至此，你已成功在Windows上完成了Windows安装Docker的全部步骤，可以开始愉快的容器化开发之旅了！