这篇教程面向刚在 Windows 11 上搭建开发/测试环境的用户：希望在本机稳定运行容器、减少环境污染，并能在遇到报错时快速定位原因。我们会完成三件事：启用 WSL2、安装并校准 Docker Desktop、建立一套可维护的镜像加速与空间清理流程。
系统版本：建议 Windows 11 22H2/23H2 及以上，并完成系统更新。
虚拟化：在任务管理器 - 性能中确认“虚拟化：已启用”。若未启用，通常需要在 BIOS/UEFI 开启 Intel VT-x / AMD-V。
磁盘规划：Docker 镜像与卷会占用较多空间，建议系统盘至少预留 30GB+，并提前考虑是否要把 Docker 数据目录放到非系统盘（文末有迁移方案）。
打开 PowerShell（管理员）执行以下命令（按需选择）：
wsl --install wsl --update wsl --set-default-version 2安装完成后，建议安装一个常用发行版（如 Ubuntu）。首次启动会要求创建 Linux 用户名与密码。
验证：确认发行版运行在 WSL2：
wsl -l -vVERSION 列显示为 2 即可。
从 Docker 官方站点下载并安装 Docker Desktop。安装过程中建议勾选“Use WSL 2 instead of Hyper-V”（如果你计划用 WSL2 作为后端）。
安装完成后打开 Docker Desktop，在设置中关注三项：
1）General：确保启用 WSL2 引擎（Use the WSL 2 d engine）。
2）Resources - WSL Integration：开启目标发行版的集成（例如 Ubuntu）。
3）Resources：根据机器配置调整 CPU/内存上限，避免把笔记本风扇拉满。
镜像拉取慢通常与网络链路有关。这里给一套通用做法：优先使用你所在网络环境可用的镜像加速服务，并把配置写在 Docker Desktop 的 Docker Engine 配置里，便于回滚与切换。
在 Docker Desktop - Settings - Docker Engine 中加入（示例结构，具体地址请换成你实际可用的镜像服务）：
{ "registry-mirrors": [ "https://your-mirror.example.com" ] }保存并重启 Docker Desktop 后生效。
说明：不同地区/运营商可用的镜像服务不一样，建议使用公司内网镜像、云厂商提供的镜像加速、或你自建的企业镜像代理（合规前提下）。不要使用来路不明的镜像源，以免引入供应链风险。
Docker Desktop 启动失败/一直卡住：先重启 Docker Desktop；再检查 Windows 功能是否启用了 WSL；最后检查是否存在虚拟化冲突（例如同时开了不兼容的虚拟机软件）。
wsl -l -v 显示发行版为 VERSION 1：执行转换：
wsl --set-version Ubuntu 2端口被占用：容器映射端口失败时，先用系统命令定位占用者，再调整容器端口映射或关闭冲突进程。
代理/公司网络访问受限：优先走合规的企业代理配置，并保持 Docker、WSL、浏览器的代理设置一致，减少“能上网但拉不下镜像”的割裂感。
Docker 空间膨胀通常来自：旧镜像层、停止的容器、未使用的卷与构建缓存。你可以按从“安全”到“激进”的顺序执行：
1）清理未使用镜像/容器：
docker system df docker system prune2）清理构建缓存（CI/频繁 build 的人很有用）：
docker builder prune3）谨慎清理卷（卷可能存着数据库数据，确认无用再做）：
docker volume ls docker volume prune清理前建议在 Docker Desktop 里看一眼“Volumes / Images”的列表，确认没有误删关键项目。
如果系统盘吃紧，可以考虑把 Docker Desktop 的数据迁移到 D 盘等更大的分区。不同版本 Docker Desktop 的数据目录/迁移方式可能略有差异，建议遵循官方文档与 Docker Desktop 的设置项（如果提供了数据目录设置优先用设置项）。
迁移的核心原则是：先备份（重要容器数据导出/备份卷），再迁移，最后验证（能否拉取/运行/重启后仍正常）。
每周一次：检查 Docker Desktop 更新、WSL 更新；清理构建缓存与未使用镜像。
每个项目：用 compose 管理服务，给镜像打清晰 tag（避免“latest 到处飘”）。
遇到异常先做两件事：1）看 Docker Desktop 的 Troubleshoot/日志；2）用最小复现（起一个 hello-world 或 nginx）确认是项目问题还是环境问题。
完成以上步骤后，你会得到一个更可控的 Windows 11 容器环境：底座是 WSL2，Docker Desktop 负责 GUI 与集成，镜像加速与清理流程可维护、可回滚。后续如果你有更细的需求（例如 GPU/CI、本地 k8s、私有镜像仓库），也建议在这个稳定底座上逐步叠加。
