Windows上配置WSL 2 Docker开发环境全攻略前言对于许多开发者来说Windows上的Linux开发环境一直是个痛点。传统的虚拟机方案资源占用大、启动慢双系统切换又太麻烦。而现在微软的WSL 2Windows Subsystem for Linux配合Docker为我们提供了近乎完美的解决方案——既能享受Windows的日常便利又能获得原生Linux的开发体验。一、环境准备1.1 系统要求Windows 10 版本 1903 或更高版本建议Windows 11支持硬件虚拟化任务管理器 性能 CPU 查看至少8GB内存推荐16GB1.2 启用必要的Windows功能以管理员身份打开PowerShell运行dism.exe/online/enable-feature/featurename:Microsoft-Windows-Subsystem-Linux/all/norestart dism.exe/online/enable-feature/featurename:VirtualMachinePlatform/all/norestart重启计算机完成安装。二、安装WSL 22.1 安装步骤# 设置WSL 2为默认版本wsl--set-default-version 2# 查看可安装的Linux发行版wsl--list--online# 安装Ubuntu 22.04 LTSwsl--install-d Ubuntu-22.04安装过程中创建Linux用户名和密码。2.2 验证安装wsl-l-v看到Ubuntu版本为2即成功。2.3 初始化Ubuntusudoaptupdatesudoaptupgrade-y三、方案一使用Docker Desktop推荐新手3.1 安装Docker Desktop从 Docker官网 下载Docker Desktop for Windows运行安装程序勾选“Install required Windows components for WSL 2”重启计算机3.2 配置WSL集成启动Docker DesktopSettings General确保“Use the WSL 2 based engine”已勾选Settings Resources WSL Integration启用Ubuntu发行版Apply Restart3.3 验证安装docker--versiondockerrun hello-world四、方案二WSL中直接安装Docker引擎4.1 安装Docker引擎sudoaptupdatesudoaptinstall-yapt-transport-https ca-certificatescurlgnupg2 software-properties-commoncurl-fsSLhttps://download.docker.com/linux/ubuntu/gpg|sudogpg--dearmor-o/usr/share/keyrings/docker-archive-keyring.gpgechodeb [archamd64 signed-by/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu$(lsb_release-cs)stable|sudotee/etc/apt/sources.list.d/docker.list/dev/nullsudoaptupdatesudoaptinstall-ydocker-ce docker-ce-cli containerd.io4.2 配置iptables兼容性sudoupdate-alternatives--configiptables选择iptables-legacy。4.3 启动Dockersudoservicedockerstart4.4 配置用户权限sudousermod-aGdocker$USER需要重新打开终端生效。五、配置Docker镜像加速器国内必备5.1 创建配置文件sudomkdir-p/etc/dockersudonano/etc/docker/daemon.json5.2 添加加速器地址{registry-mirrors:[https://docker.1ms.run,https://docker.xuanyuan.me]}5.3 重启Docker服务sudosystemctl daemon-reloadsudosystemctl restartdocker5.4 验证加速器dockerinfo|grep-A5Registry Mirrors六、常见问题排查6.1 WSL 2内存占用过高在Windows用户目录创建.wslconfig[wsl2] memory4GB processors2 localhostForwardingtrue重启WSLwsl--shutdown6.2 Docker服务无法启动sudodockerd--debug6.3 文件权限问题sudochmod777/mnt/d/你的文件夹七、总结通过WSL 2和Docker的结合Windows已经成为一个强大的Linux开发平台。两种方案适用场景Docker Desktop方案适合新手、需要图形界面管理原生Docker引擎方案适合追求纯粹性、需要与生产环境一致配置好镜像加速器后国内访问Docker Hub将变得流畅许多。祝配置顺利