Windows上跑容器这几年一直是开发环境里最拧巴的一件事。早期靠VirtualBox拖个Linux虚拟机后来用Docker Desktop靠Hyper-V结果不是性能损耗大就是配置复杂到劝退新手。这两年的WSL2Windows Subsystem for Linux 2算是把局面彻底改变了——它把Windows和Linux的边界直接抹掉让开发者在Windows下用原生的Docker Engine跑容器代码、数据、命令行全都待在Linux环境里启动速度和资源占用却近乎原生。我实践小半年下来这套组合已经成了主力开发环境。这篇指南写给谁主要是在Windows上做开发、又不想装双系统或整天开着虚拟机的人。不管你做后端、做前端、搞数据处理还是学深度学习只要需要容器环境又想在Windows下干活这套方案都值得一试。我会把安装WSL、把它迁到D盘、装好Docker Engine、跑起MySQL和Redis这几个完整流程讲清楚最后把我踩过的那些坑逐个拆一遍基本做到读完就能照着复现。1. 环境准备与核心思路解析1.1 WSL2凭什么成为Windows下的容器首选很多人第一次接触WSL以为它就是个把Ubuntu塞进Windows的玩具终端实际远不止如此。WSL2和WSL1是两代完全不同的实现WSL1里Linux的系统调用靠翻译层转成Windows系统调用兼容性差Docker跑不了WSL2则直接跑在轻量虚拟机里内核是真正的Linux内核系统调用百分百兼容。Docker容器依赖的cgroups、namespace、iptables这些底层能力WSL2全都有跑Docker Engine毫无压力。对比一下更直观方案性能磁盘占用启动速度与Windows文件互访Docker支持传统虚拟机一般大几个GB起慢需要通过共享目录繁琐完全支持Docker Desktop中等中等中等与Windows深度集成开箱即用但资源占用高WSL2 Docker Engine接近原生小1GB左右秒级直接通过/mnt/c访问完全支持轻量可控WSL2的IO性能虽然比纯Linux物理机还是有差距尤其跨文件系统操作时明显但纯容器场景镜像拉取、容器读写、网络转发跑起来体感完全够用。我的项目里同时跑两三个MySQL、Redis、Nginx容器内存占用控制在几个GB内开发时几乎感受不到性能瓶颈。1.2 安装前的硬件与系统要求WSL2本质是虚拟机所以CPU虚拟化必须开启。Intel的VT-x、AMD的SVM这一步是硬门槛。检查方法很简单打开任务管理器切到性能标签页看CPU那一栏有没有虚拟化已启用。如果显示未启用需要进BIOS里找“Intel Virtualization Technology”或“SVM Mode”等选项打开具体路径不同主板差异很大但基本都在“Advanced”或“CPU Configuration”菜单下。系统版本方面Windows 10 2004build 19041以上或Windows 11都支持。Windows 10老版本1809及更早虽然也能装WSL2但需要手动开启虚拟机平台功能和下载WSL2内核更新包麻烦不少。我的建议是直接升级到最新的Windows 10 22H2或Windows 11稍后提到的wsl --install一条命令就能全部搞定。前置组件方面需要保证Windows功能中的适用于Linux的Windows子系统和虚拟机平台都已启用。用管理员权限的PowerShell运行Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux和对应虚拟机平台指令即可当然更省事的是用下面要说的wsl --install。2. WSL安装与基础配置实操2.1 用一条命令完成WSL安装与Ubuntu部署安装WSL大多数人第一步就卡在了不知道用什么命令。其实在Windows 10 2004之后的版本微软已经把安装流程全部整合进了一条命令。以管理员身份打开PowerShell或Windows Terminal输入wsl --install这条命令会依次完成启用WSL功能、启用虚拟机平台、下载并安装WSL2内核、默认安装Ubuntu发行版。如果你的系统只装了Windows 11连重启都可能省了直接一次到位。如果你老系统上有旧版WSL需要先更新内核会出现一条WSL needs updating的提示此时手动下载最新的WSL安装包覆盖安装即可。系统重启后Ubuntu终端会自动弹出让你设置Linux用户名和密码。这一步要注意填入的账户是Linux系统的独立账户和Windows用户不是一回事。虽然第一次进入会提示输入Windows密码用于提权但一旦Linux账户设置完毕后续在WSL内都是独立的。有两点比较重要第一默认安装在C盘后面专门说怎么挪走第二如果安装后没有自动弹出Ubuntu窗口可以用wsl --list --verbose查看系统状态如果显示Ubuntu已安装直接运行wsl命令也能手动进入。2.2 把WSL迁到D盘别让C盘遭殃WSL被装到C盘后镜像、数据、容器层全都堆在系统盘。Ubuntu基础镜像加几个常用容器几十GB很常见。C盘不够住的同学看完这步再动手。WSL的迁移不像普通软件卸载重装官方没有提供一键移动。正确思路是先导出整个发行版为一个tar文件注销原发行版再导入到目标盘。具体操作如下# 1. 先停掉WSL防止文件被占用 wsl --shutdown # 2. 导出Ubuntu到D盘临时目录 wsl --export Ubuntu D:\wsl-backup\ubuntu.tar # 3. 注销原发行版注意这不会删掉导出的tar文件 wsl --unregister Ubuntu # 4. 导入到D盘新目录并把发行版名称保持为Ubuntu wsl --import Ubuntu D:\WSL\Ubuntu D:\wsl-backup\ubuntu.tar # 5. 删除临时tar文件 Remove-Item D:\wsl-backup\ubuntu.tar导入完成后用wsl -d Ubuntu进入系统你会发现用户目录结构变了——原来用wsl --export导出的tar导入后默认以root身份进入且之前的用户配置全部丢失。解决办法是重新设置默认用户在Ubuntu中执行echo -e [user]\ndefault你的用户名 | sudo tee /etc/wsl.conf然后wsl --terminate Ubuntu再重新进入就变回原来的用户了。我迁移过两次第一次忘了配置default用户折腾了好一阵。这一步如果没做后续所有Docker命令都会以root身份执行虽然能用但文件归属和权限管理会很乱。2.3 换国内软件源安装依赖不再龟速WSL装完后默认的Ubuntu软件源指向国外服务器apt update的速度能急死人。这一步在做任何安装之前先干完尤其是要安装大量依赖的Docker场景。编辑源文件前先备份然后替换为国内镜像。以清华镜像源为例sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak sudo sed -i s/http:\/\/archive.ubuntu.com/http:\/\/mirrors.tuna.tsinghua.edu.cn/g /etc/apt/sources.list sudo sed -i s/http:\/\/security.ubuntu.com/http:\/\/mirrors.tuna.tsinghua.edu.cn/g /etc/apt/sources.list sudo apt update不同的Ubuntu版本源路径可能有些出入。如果你是Ubuntu 22.04及以上默认源文件已经换成了/etc/apt/sources.list.d/ubuntu.sources需要手动打开这个文件替换。用vim或者nano编辑把里面http://archive.ubuntu.com和http://security.ubuntu.com的主机名改成mirrors.tuna.tsinghua.edu.cn即可。替换完源后顺手把基础的build-essential、curl、git装上后面编译和脚本拉取都用得上。这一步做完WSL基础环境基本齐活可以进入装Docker的阶段了。3. 在WSL2中安装并运行Docker引擎3.1 选Docker Engine还是Docker Desktop我的选择Docker Desktop是图形界面全家桶装完就能用但说实话在WSL场景下有点笨重。它自带了一个WSL后端底层还是会起自己的虚拟机跟WSL2的方案重叠资源占用却不小。而且Docker Desktop的许可证对大型企业收费个人和小团队用倒无所谓但总感觉绑手绑脚。我更推荐直接在WSL2里装Docker Engine——就是Linux世界里真正的Docker服务没有任何可视化外壳干净、轻量、完全可控。日常开发根本不需要图形界面用docker命令操作一切。WSL2的localhost转发机制让Windows可以直接访问容器端口配合VS Code的Remote-WSL插件开发体验和纯Linux几乎没有区别。Docker Engine在WSL2里跑还有一个好处容器数据直接存放在Linux的vhdx虚拟磁盘文件里天然和Windows隔离。不想用了wsl --unregister Ubuntu一删全部干净不留一点垃圾。3.2 安装Docker Engine的完整步骤Docker官方提供了脚本一条龙安装但这个脚本默认从官方源拉包国内网络环境下经常卡住。我建议走两条路。第一条用国内镜像站提供的安装脚本。以DaoCloud的脚本为例curl -fsSL https://get.daocloud.io/docker -o get-docker.sh sudo sh get-docker.sh脚本会帮你配好Docker的apt源省去手动配源的麻烦。装完后运行sudo docker version查看版本确认装上了。第二条手动配置清华或阿里云的Docker源后安装。阿里云镜像站提供了详细的说明核心就是添加gpg密钥和docker-ce源# 安装依赖 sudo apt update sudo apt install -y ca-certificates curl gnupg lsb-release # 配置GPG密钥 sudo install -m 0755 -d /etc/apt/keyrings curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg sudo chmod ar /etc/apt/keyrings/docker.gpg # 添加源 echo deb [arch$(dpkg --print-architecture) signed-by/etc/apt/keyrings/docker.gpg] https://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable | sudo tee /etc/apt/sources.list.d/docker.list /dev/null # 安装 sudo apt update sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin安装完成后WSL2里默认不会自动启动Docker服务需要手动启动。每次WSL启动后第一件事就是执行sudo service docker start。如果不想每次手动可以编辑/etc/wsl.conf开启systemd支持[boot] systemdtrue改完后wsl --terminate Ubuntu再重进sudo systemctl enable docker就能做到开机自启了。不过我实测下来即使没有systemd用service docker start启动也只要一两秒习惯了倒也顺手。最后把你的用户加入docker组免得每个命令都加sudosudo usermod -aG docker $USER重新登录后执行docker run hello-world验证看到Hello from Docker!就说明环境通了。3.3 实战部署MySQL 8.0和Redis 7实例环境通了立刻跑个真实项目练手。我这里部署两个最常用的容器MySQL 8.0和Redis 7。先跑MySQL要数据持久化必须挂载数据卷否则容器一删数据全没了docker run -d \ --name mysql8 \ -p 3306:3306 \ -e MYSQL_ROOT_PASSWORD你的密码 \ -e MYSQL_DATABASEtestdb \ -v mysql_data:/var/lib/mysql \ mysql:8.0mount数据卷用Docker管理的方式mysql_data数据和容器生命周期解耦即使容器意外删除数据还在。执行完docker ps查看状态容器变成Up状态就说明启动正常。用Navicat或MySQL客户端连localhost:3306验证连通性。如果连接超时多半是Windows防火墙拦截了WSL的端口稍后单独细说。Redis稍微简单些但生产场景下一定要开启AOF持久化docker run -d \ --name redis7 \ -p 6379:6379 \ -v redis_data:/data \ redis:7 \ redis-server --appendonly yes用-v redis_data:/data把写入的持久化文件保留下来appendonly yes开启AOF这样Redis重启或容器重建数据都还在。连上Redis后set一个键值再docker restart redis7验证数据是否保留基本就确认配置没问题了。两个容器的端口映射在WSL2下有个天然的便利——不需要配置任何额外网络Windows下直接访问localhost:3306和localhost:6379就能连进去。这点比传统虚拟机省心太多了。4. 常见问题与排查技巧实录4.1 WSL安装慢、卡在下载进度条的根治方案wsl --install唯一让人头疼的就是下载慢。微软官方服务器在国内连接不稳定进度条卡在几个百分比一卡就是半小时。如果你遇到了别干等用cd到临时目录手动下载发行版压缩包的方式绕过去。先从微软官方提供的WSL发行版下载链接或者用社区打包的镜像下载Ubuntu Appx包或.tar.gz压缩包。我这里以常见的Ubuntu 22.04 tar包为例# 下载完成后在压缩包所在目录执行导入目录要先创建好 wsl --import Ubuntu D:\WSL\Ubuntu .\ubuntu-22.04.tar.gz wsl -d Ubuntu导入完成后按之前说的方法配置/etc/wsl.conf的default用户即可。这种方式比在线安装稳定得多不受网络波动影响而且能自由选择发行版版本比如你想装Debian、CentOS如果还有的话也能走同样流程。需要注意wsl --import和wsl --install两种方式安装的发行版默认用户的处理不一样import方式不会自动弹窗让你设置用户名密码必须手动修改wsl.conf配置default用户。4.2 “Virtualization support not detected”和HCS错误排查装WSL时最容易碰到的两路报错一块是被任务管理器显示虚拟化未启用另一块是安装过程中出现错误代码wsl/installdistro/service/registerdistro/createvm/hcs/error_file_n。第一种情况核心就是BIOS里没开虚拟化。按我说的检查任务管理器性能页的虚拟化状态。如果显示已禁用重启进BIOS找Intel VT-x或AMD SVM选项打开保存退出。如果BIOS里已经打开了但Windows还是显示未启用多半是Win11系统安全中心的内核隔离或Hyper-V相关组件没开。以管理员身份运行Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform完成后重启一般就能解决。第二种HCS错误是Windows的Hyper-V Host Compute Service无法创建虚拟机导致的。这个错误最常见的原因有三类虚拟化功能未启用上面说的第一类、WSL2内核版本过旧、以及Windows的Hyper-V组件损坏。排查顺序# 1. 查看当前WSL版本和内核版本 wsl --version # 2. 更新WSL到最新版本 wsl --update # 3. 关闭并重开虚拟机平台功能以管理员身份 Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform注意关闭再开启虚拟机平台会要求重启而且目前已有WSL发行版不受影响放心操作。如果重启后依旧报错看看Windows更新是否积压了太多补丁。WSL2高度依赖Windows虚拟机平台组件版本太老的Windows 10尤其容易出这类问题。还有一个容易忽略的点第三方安全软件或优化工具可能干扰虚拟化功能。我之前有一台机器装了某管家类软件虚拟化一直显示禁用卸载后立马正常。遇到HCS错误时可以暂时停用这类软件再试。4.3 WSL和Windows之间的端口冲突与访问问题WSL2和Windows共享网络但端口占用规则并不透明。最常见的是Windows上已经有个程序占了3306而WSL里MySQL又绑了3306结果容器能起来但Windows下死活连不上。排查步骤# Windows下查看端口占用 netstat -ano | findstr 3306 # 如果查到了占用进程的PID查看进程信息 tasklist /FI PID eq 具体的PID确认是某个Windows程序占了端口后在Windows管理员PowerShell下结束进程taskkill /PID 具体的PID /F结束前确认不是重要系统进程。另一个更好的做法是干脆把容器的映射端口改掉比如MySQL用3307这样跟Windows已有服务彻底分开。还有一类问题是WSL2的IP地址是动态的每次重启都会变。如果你在Windows里用wsl hostname -I拿到的IP去访问容器下次重启就会失效。这其实不用管WSL2的localhost转发特性已经帮你做了映射直接用localhost访问即可。如果发现localhost转发失效执行wsl --shutdown后重新启动WSL通常能恢复。跨文件系统访问是另一个坑。在WSL里直接操作/mnt/c下的文件比如把Windows下载的包复制到WSL路径文件IO速度会非常慢因为要跨系统翻译。正确的做法是所有开发文件都放在Linux文件系统比如~/project要传递文件时再用cp从/mnt/c拷进来保证容器挂载和读写都在Linux侧完成。4.4 磁盘膨胀和内存占用问题的优化实测WSL2用了一段时间后C盘爆掉是常见惨案。根源是vhdx虚拟磁盘文件整个WSL的Linux文件系统都封装在这个文件里只增长不收缩即便删了数据文件体积也不会自动降下来。处理方法先wsl --shutdown停止WSL再用diskpart压缩vhdx文件# 管理员身份打开diskpart diskpart # 选择WSL虚拟磁盘文件 select vdisk fileC:\Users\你的用户名\AppData\Local\Packages\CanonicalGroupLimited.Ubuntu_*\LocalState\ext4.vhdx # 压缩磁盘 compact vdisk # 退出 detach vdisk exit压缩前最好在WSL里执行sudo fstrim -av清理一下文件系统内未使用的块压缩效果会好很多实测一个40GB的vhdx能压到15GB。内存占用方面WSL2默认最多占用Windows物理内存的50%如果开发机上内存只有16GB会出现卡顿。在Windows用户目录下创建.wslconfig文件限制WSL的内存和CPU[wsl2] memory8GB processors4 swap2GB改完wsl --shutdown再启动生效。注意这个文件是写在Windows用户主目录下C:\Users\你的用户名.wslconfig不是WSL内部。我实机测试同时跑三个容器加一个Node服务内存控制在6GB内日常开发非常流畅。最后说说Docker映像和容器自带的存储占用。WSL2里Docker的所有数据默认存在/var/lib/docker长期使用后体量很可观。定期docker system prune -a清理未使用的容器、镜像、缓存能释放大量空间。这个命令会删掉所有没被容器引用的镜像执行前确认一下没有需要保留的构建缓存。个人实操的几点体会整套环境我用了小半年完全替代了之前的Vmware虚拟机方案。有几个细节是踩过坑才真正体会到的。WSL2确实是Windows下跑Docker最轻的方式。Docker Desktop虽然开箱即用但底层多包了一层虚拟化资源占用至少翻倍。如果你愿意花十分钟敲点命令直接用Docker Engine绝对值得。前提是别在C盘积累太多数据越早迁移越好等C盘爆了再迁会麻烦得多。另外一定要习惯在WSL的Linux文件系统里工作不要为了图方便把代码放在Windows侧再跨系统读写。容器挂载Windows目录比如/mnt/c/project时文件监视inotify完全失效热重载、文件监听这类功能可能时灵时不灵。把项目代码挪到WSL的~/目录下所有问题一步解决。还有个小技巧在VS Code里装好Remote-WSL插件然后用code命令在WSL里打开项目目录写代码、跑终端、改配置全在Linux环境里Windows侧完全不需要装任何开发工具。这种工作流才是WSL2的真正魅力所在。