在开始前请先确认：
1）Windows 建议为 Windows 10 22H2 / Windows 11；macOS 建议为较新的稳定版本。
2）你有本机管理员权限（能安装软件、开启系统功能）。
3）如果公司网络有代理/网关限制，提前准备可用的网络方案（本文会讲镜像加速与代理设置思路）。
步骤 1：开启必要的系统功能
打开“启用或关闭 Windows 功能”，勾选：
- 适用于 Linux 的 Windows 子系统（WSL）
- 虚拟机平台（Virtual Machine Platform）
按提示重启。
常见提示：部分电脑 BIOS/UEFI 里需要开启虚拟化（Intel VT-x / AMD-V）。如果后面遇到虚拟化相关报错，优先检查这里。
步骤 2：安装/升级 WSL2
在 Windows 设置里确认 WSL 已可用后，再将默认版本设为 WSL2（如果你已经在用 WSL，可跳过安装只做版本检查）。
要点：Docker Desktop 的 WSL2 模式会把 Linux 容器运行在轻量虚拟化环境里，性能与兼容性更好。
步骤 3：安装 Docker Desktop
下载安装 Docker Desktop 并完成安装。首次启动会提示选择后端（WSL2/Hyper-V），建议选择 WSL2。
安装完成后打开 Docker Desktop，等待状态变为“Running/正在运行”。
步骤 1：选择正确的安装包
- Apple 芯片（M1/M2/M3）选择 Apple Silicon 版本
- Intel 机型选择 Intel 版本
步骤 2：首次运行授权
首次启动需要授予网络/系统扩展权限时按提示操作。若系统安全策略阻止，去“系统设置 → 隐私与安全性”里允许相关组件。
思路 1：Docker Desktop 的镜像源配置
在 Docker Desktop 的设置中找到与 Docker Engine/镜像仓库相关的配置入口，将常用镜像源加入配置（不同版本界面略有差异）。
思路 2：配合代理（如你在公司网络）
如果必须走代理：
- 在 Docker Desktop 设置中配置 HTTP/HTTPS 代理
- 同时确认系统代理与 Docker 守护进程代理一致
注意：代理账号/密码尽量使用系统安全存储方式，不要写进脚本或公开配置。
1）限制 CPU/内存
Docker Desktop 可以设置 CPU/内存上限。建议按机器配置保守一些，例如：
- 16GB 内存机器：给 Docker 4~6GB 起步
- 32GB 内存机器：给 Docker 6~10GB 视情况调整
2）控制磁盘占用
镜像/容器/构建缓存会持续增长。建议定期清理无用资源，尤其是频繁构建项目时。
3）Windows 下的 WSL 磁盘位置
WSL2 的数据文件会随时间变大。若 C 盘紧张，优先把项目工作区放到空间更大的磁盘，并关注 Docker/WSL 的数据目录管理策略。
检查 1：Docker Desktop 状态
打开 Docker Desktop，确保无红色报错，状态为运行中。
检查 2：命令行可用
在终端里输入 docker 相关命令能看到帮助信息，说明 CLI 正常。
检查 3：拉取并运行一个示例容器
尝试拉取一个小体积镜像并运行，观察是否能正常启动与退出。
1）提示虚拟化未开启 / 无法启动 WSL2
优先检查：BIOS/UEFI 是否开启虚拟化；Windows 功能是否勾选了 WSL 与“虚拟机平台”；系统是否重启生效。
2）一直卡在 Starting / 正在启动
处理顺序建议：
- 先重启 Docker Desktop
- 再重启电脑
- 检查安全软件/公司管控是否拦截虚拟化组件
3）拉取镜像超时、速度极慢
通常是网络问题。按顺序排查：
- 镜像源是否配置正确
- 代理是否生效（系统代理 vs Docker 代理）
- 公司网络是否限制外网仓库访问
4）磁盘占用飙升
优先清理无用镜像/容器与构建缓存；减少重复构建产物；对大项目启用合理的构建缓存策略。
1）为每个项目写清楚运行方式：需要哪些端口、环境变量、数据卷。
2）给 Docker 分配合理资源，避免与 IDE/浏览器抢内存。
3）定期清理无用资源，保持环境干净。
4）遇到问题先定位层级：系统虚拟化 → WSL/Hypervisor → Docker Desktop → 镜像网络 → 容器本身。
