安装 WSL 并启用子系统

确保 Windows 10 版本 2004 或更高（或 Windows 11），以管理员身份打开 PowerShell 运行以下命令：

wsl --install

重启系统完成基础安装。若需手动启用，执行：

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

选择并安装 Linux 发行版

推荐 Ubuntu LTS 或 Debian 作为 Docker 宿主系统，通过 Microsoft Store 直接安装。安装后启动发行版完成初始化设置，创建用户名和密码。

将 WSL 2 设为默认版本

在 PowerShell 中执行版本切换：

wsl --set-default-version 2

验证已安装的发行版是否为 WSL 2：

wsl --list --verbose

安装 Docker Desktop for Windows

从 Docker 官网下载稳定版安装包，安装时勾选以下选项：

• Use WSL 2 instead of Hyper-V
• Install required Windows components for WSL 2

安装完成后启动 Docker Desktop，在设置 > Resources > WSL Integration 中启用对应发行版的集成。

验证安装与版本适配

在 WSL 终端中运行测试命令：

docker run hello-world

版本适配建议：

• Windows 10 21H2+/11 + WSL 2：兼容 Docker Desktop 4.25+
• Ubuntu 22.04 LTS：适配 Docker Engine 24.0+
• 企业环境建议锁定 Docker Desktop 4.18 等长期支持版本

常见问题速查

若出现 The command 'docker' could not be found，检查 PATH 是否包含 /usr/bin 或执行：

sudo usermod -aG docker $USER

网络问题可尝试在 Docker Desktop 设置中重置 DNS 或配置 .wslconfig 文件。