先讲个我前两天遇到的场景。一个同事想在本机跑个MySQL容器做开发测试,顺手点开了网上的教程,结果卡在Docker Desktop启动上——不是报虚拟化支持未检测到,就是WSL状态异常,前前后后折腾了个把小时。我说你不如直接把Docker装进WSL2里,省掉中间那层Windows图形界面的翻译和调度,他半信半疑试了试,十分钟后容器已经跑起来了。
这类情况我见过太多次。Windows上装Docker,方向其实就两个:要么用Docker Desktop的WSL2后端,要么直接在WSL2的Linux发行版里装原生的Docker Engine。而大多数出问题的人,问题根源恰恰出在第一步——WSL2本身没装好,或者压根没理解这两者之间是什么关系。所以这篇我打算从WSL2和Docker的底层关系讲起,把安装、选型、配置、报错排查一条线串下来,确保你既能照着做,也能理解每一步在干什么。
这篇内容适合:刚接触WSL的Windows用户、在本地搞开发但不想开虚拟机的同学、以及被Docker Desktop各种启动报错折磨过的朋友。核心假设是你对Linux命令有一点基础,但即便完全没有,照着步骤抄也能完成。
1. 为什么是WSL2,而不是虚拟机或Windows原生Docker
1.1 从Docker为什么不能在Windows原生跑说起
很多人第一次接触Docker时会有个困惑:Docker明明是跨平台的,为什么Windows上装起来这么痛?这里得先搞清楚一个基础事实——Docker本身不是虚拟机,它依赖Linux内核提供的namespace、cgroups、overlayfs这些底层机制来实现容器隔离和镜像分层。Windows内核没有这些机制,所以Docker不能在Windows上"原生"运行。
那Windows上到底怎么跑?两条路:
- 在虚拟机里跑一个完整的Linux系统,然后在Linux系统里跑容器。
- 用Windows提供的内核级虚拟化平台,由Docker Desktop帮你起一个极简Linux虚拟机,把容器塞进去。
早期Docker Toolbox走的是第一条路,基于VirtualBox,体验很糟糕。后来Docker Desktop基于Hyper-V,依然是个重量级方案,而且和很多VirtualBox、VMware、安卓模拟器的虚拟化方式冲突。直到WSL2出现,Windows上跑Docker这件事才变得体面。
WSL2本质上是一个轻量级虚拟机,但它和传统虚拟机有一个关键区别:它不是完整提供一套硬件抽象,而是通过虚拟化技术直接承载一个真正的Linux内核。也就是说,你在WSL2里运行的不是模拟器,而是一个原生Linux,只是这个Linux生活在Windows的VM里。正因如此,Docker的依赖——namespace、cgroups、overlayfs——WSL2里全都满足。
1.2 WSL2和WSL1的区别,以及和VirtualBox/Hyper-V的对比
很多老教程还在提WSL1。WSL1和WSL2虽然都叫WSL,但架构完全不同:
- WSL1是系统调用翻译层,把Linux系统调用翻译成Windows调用,没有真正的Linux内核。对于大多数用户态应用够用,但对Docker这种需要内核特性的软件就是不支持。你在WSL1里尝试装Docker,多半会失败。
- WSL2是轻量级虚拟机,跑着货真价实的Linux内核,兼容性接近原生Linux。
所以你在网上看到"The command 'docker-compose' could not be found in this WSL 1 distro"这类报错,多半是发行版还跑在WSL1模式下,解法是把它切到WSL2,后面我会专门讲。
和VirtualBox、Hyper-V这类完整虚拟机相比,WSL2的优势也非常明显:
- 启动快。WSL2的VM是随用随启的,通常几秒内就能进入一个可用shell。相比之下,完整虚拟机光开机就得几十秒。
- 资源占用低。WSL2默认动态分配内存和CPU,不用你手动划个固定的4GB内存,宿主Windows内存紧张时会自动回收。
- 和Windows集成好。这是最让人上瘾的一点。在WSL2里可以直接用
explorer.exe .打开Windows资源管理器,Windows的命令行可以无缝调用WSL里的命令,本地开发的时候可以同时在Windows侧用IDE、在Linux侧跑容器。 - 文件互通。Windows的磁盘会挂载到
/mnt/c,WSL2里的文件也能通过\\wsl$\路径从Windows侧直接访问。
1.3 两种最主流的装机路线
明白了WSL2的定位,你就会知道当前主流方案为什么是下面两种:
路线A:Docker Desktop for Windows,开启WSL2后端。Docker引擎实际跑在WSL2里,但Docker Desktop提供Windows图形界面、托盘图标、开机自启、Docker Compose集成,界面友好,是大多数初学者的首选。
路线B:直接在WSL2里装Docker Engine(通常是Ubuntu发行版)。不装Docker Desktop,而是在Linux shell里操作docker命令。这套方案更接近生产环境,适合那些想要纯净、可控、资源占用更低,或者项目本身部署目标就是Linux服务器的人。
我自己的日常主力是路线B,但也不排斥路线A。具体怎么选,我放在第3章详细展开,这里先不纠结。但无论选哪条路线,第一步都一样:把WSL2装好。这是绕不开的地基。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. WSL2安装:第一步就决定成败
2.1 安装前必须确认的三件事
WSL2能不能顺利装,很多时候不是命令敲错,而是环境没准备好。和"virtualization support wasn't detected"这类Docker Desktop报错一样,问题往往出现在虚拟化这一层。所以下面的确认顺序值得认真做一遍。
- 确认Windows版本。
WSL2要求Windows 10 2004及以上,或者Windows 11。如果你的Windows还停留在旧版本,最好的建议是先更新系统。注意,这里说的Windows 10 2004不是随便看看系统版本号,而是指2020年5月更新那一版及以后的系统。怎么看?Win+R输入winver,弹出的窗口里看版本号。
- 确认CPU虚拟化已在BIOS开启。
这是最容易被忽略的一步。打开任务管理器 -> 性能 -> CPU,看右下角"虚拟化"是否显示"已启用"。如果显示"已禁用",需要进BIOS开启Intel VT-x(Intel平台)或AMD-V(AMD平台)。不同主板的BIOS菜单位置不一样,一般在Advanced或Security菜单下找"Intel Virtualization Technology"这类选项。这一步不做,后面整个WSL2、Docke
