WSL 2 环境配置

确保 Windows 10/11 版本为 2004 或更高，需启用虚拟化和 WSL 2 功能。以管理员身份运行 PowerShell 执行以下命令：

wsl --install
wsl --set-default-version 2

安装 Docker Desktop

从官网下载 Docker Desktop for Windows 安装包，安装时勾选"Use WSL 2 instead of Hyper-V"选项。安装完成后在设置中确认：

• Resources > WSL Integration 启用对应发行版
• General 页勾选"Use the WSL 2 based engine"

验证安装

在 WSL 终端运行以下命令测试：

docker run --rm hello-world

正常输出应显示 Hello from Docker 的欢迎信息。检查版本信息：

docker --version
docker-compose --version

常见问题处理

当出现"WSL 2 installation is incomplete"错误时，需手动下载内核更新包。防火墙冲突可尝试关闭公共网络防火墙规则。磁盘空间不足可通过 WSL 配置调整：

[wsl2]
memory=4GB
swap=8GB
localhostForwarding=true

性能优化配置

在 Docker Desktop 设置中调整：

• 内存分配建议为宿主机的 50-70%
• 启用"Experimental features"获取新功能
• 修改镜像存储位置避免 C 盘爆满

代码示例：创建并运行 Nginx 容器

docker run -d -p 8080:80 --name my-nginx nginx

访问 http://localhost:8080 即可验证服务运行状态。