Docker + WSL2 零踩坑安装与配置：Windows 开发环境一键就绪

这篇文章适合谁

如果你在 Windows 上做开发，希望用 Docker 跑数据库、缓存、消息队列或本地服务，但又不想被虚拟机/网络/磁盘坑到，这份「Docker + WSL2」配置清单就是给你的。目标是：安装一次、稳定可用、后续迁移/重装也不慌。

准备工作：先把地基打牢

1）确认系统与权限：建议 Windows 11（或 Windows 10 22H2）+ 管理员权限。企业设备如果有策略限制，先确认能启用虚拟化相关功能。

2）开启 CPU 虚拟化：在 BIOS/UEFI 中开启 Intel VT-x / AMD-V（不同主板叫法不同）。若未开启，后续 WSL2/Docker 往往会报错或启动失败。

3）准备磁盘空间：容器镜像会很快变大。建议预留 20GB+，并想好是否需要把数据盘迁移到非系统盘（后面有方法）。

步骤一：安装并启用 WSL2

1）安装 WSL：打开「设置 → 应用 → 可选功能 → 更多 Windows 功能」（或使用系统自带的 WSL 安装入口），确保启用 WSL 与虚拟机平台相关组件。

2）选择发行版：推荐 Ubuntu LTS。安装后首次启动会让你创建 Linux 用户名和密码（这是 Linux 内部账户，不等同于 Windows 账户）。

3）更新与基础工具：进入发行版后先做系统更新，并安装常用工具（git、curl、ca-certificates 等），避免后续拉取依赖时遇到证书或网络问题。

步骤二：安装 Docker Desktop 并切换到 WSL2 后端

1）安装 Docker Desktop：从官方渠道下载并安装，安装过程中保持默认选项即可。

2）启用 WSL2 引擎：在 Docker Desktop 设置里确认使用 WSL2 作为引擎（不同版本的入口名称略有差异）。

3）给发行版授权：在「Resources/WSL Integration」中勾选你要用于开发的 Linux 发行版（例如 Ubuntu）。这一步能让你在 WSL 里直接使用 docker 命令。

步骤三：性能与资源限制（建议立刻做）

1）限制 CPU/内存：如果你经常开很多 IDE/浏览器，建议给 Docker/WSL 设置合理上限，避免把整机吃满导致卡顿。

2）控制磁盘增长：容器镜像与构建缓存会不断增大。养成定期清理无用镜像与构建缓存的习惯（只清理你确认不用的内容）。

3）项目放哪更快：一般建议把代码放在 WSL 的 Linux 文件系统里进行构建/依赖安装（Node/Python/Rust 等），可减少跨文件系统带来的性能损耗。

步骤四：常见问题排查（按现象定位）

现象A：Docker 启动失败/提示虚拟化不可用：优先检查 BIOS 虚拟化是否开启，其次检查 Windows 功能里的虚拟机平台相关组件是否启用。

现象B：拉镜像很慢：先确认网络环境稳定，再检查 DNS 设置与代理设置是否正确；企业网络可能需要白名单或代理配置。

现象C：磁盘占用飙升：通常是镜像/构建缓存累积导致。建议先在 Docker Desktop 查看占用来源，再有选择地清理无用内容。

现象D：端口冲突：本机已有服务占用端口时，优先在 compose 中改映射端口，或停掉冲突的本机服务，避免「一会儿能用一会儿不能用」。

安全与最佳实践（不折腾也能稳）

1）只用可信镜像源：尽量选择官方镜像或知名维护者镜像，避免来路不明的镜像携带风险。

2）不要把敏感信息写进镜像：密钥、Token、密码用环境变量或安全的密钥管理方式注入，不要写死在 Dockerfile 或提交到仓库。

3）用 compose 管理服务：数据库、缓存、队列这类依赖用 compose 一键启动/停止，项目切换更干净，复现也更容易。

完成检查清单（3分钟自测）

✅ WSL 发行版能正常启动并联网

✅ Docker Desktop 能正常启动且显示 Engine 运行中

✅ 在 WSL 里能执行 docker 命令并看到版本信息

✅ 能启动一个简单容器并通过浏览器访问对应端口

到这里，你的 Windows 容器开发环境基本就稳定了。后续只要把常用 compose 项目模板保存好，就能做到「新电脑/重装后半小时恢复工作流」。