1）系统：Windows 10 21H2+/Windows 11（建议最新版）。
2）硬件：CPU 支持虚拟化（Intel VT-x / AMD-V），并在 BIOS/UEFI 里开启。
3）权限：需要管理员权限安装组件；公司电脑请先确认策略允许启用虚拟化/WSL。
步骤 1：打开 WSL 功能
在“启用或关闭 Windows 功能”里勾选：
• 适用于 Linux 的 Windows 子系统（WSL）
• 虚拟机平台（Virtual Machine Platform）
重启电脑后继续。
步骤 2：安装/更新 WSL
打开 Microsoft Store，搜索并安装“Windows Subsystem for Linux”（或在设置里更新）。
步骤 3：安装一个 Linux 发行版
推荐 Ubuntu LTS。首次启动会让你创建 Linux 用户名与密码。
步骤 1：下载安装包
从 Docker 官网下载 Docker Desktop for Windows（不要用来路不明的安装包）。
步骤 2：安装时的关键选项
安装向导里勾选“Use WSL 2 instead of Hyper-V”（如果有）。安装完成后启动 Docker Desktop。
步骤 3：在 Docker Desktop 里启用 WSL 集成
Settings → Resources → WSL Integration：勾选你安装的发行版（如 Ubuntu）。
验证 1：Docker Desktop 状态
任务栏图标显示“Docker Desktop is running”。
验证 2：在 Windows 终端执行
docker version docker info验证 3：跑一个 hello-world 容器
docker run --rm hello-world能看到欢迎输出就说明镜像拉取、容器运行都没问题。
1）提示虚拟化未开启 / WSL2 无法启动
检查 BIOS/UEFI 的虚拟化开关是否打开；同时在任务管理器 → 性能 → CPU，确认“虚拟化：已启用”。
2）Docker Desktop 一直 Starting… 或提示 daemon 未启动
先重启 Docker Desktop；仍不行时：Settings → Troubleshoot → Restart / Clean 或查看日志。公司电脑常见原因是安全软件/策略拦截虚拟化。
3）WSL 更新失败 / 发行版打不开
优先通过 Microsoft Store 更新 WSL；如果发行版损坏，可以在“应用和功能”里修复/重置（注意会影响发行版数据）。
4）拉取镜像很慢（网络问题）
不要找“破解/绕过付费”的方案。建议：更换网络、使用合规镜像加速（公司有镜像仓库就用内部仓库）、或在空闲时段拉取。
5）端口占用：bind: address already in use
说明本机已有程序占用端口。换端口或关闭占用进程；排查时可从容器映射端口入手。
1）给 WSL2 合理的资源限制（内存/CPU），避免把电脑跑满。
2）项目文件尽量放在 Linux 发行版文件系统里（WSL 内部路径），大量小文件读写更快。
3）定期清理无用镜像/容器，但发布/生产环境请谨慎。
1）打开 Docker Desktop 确认运行。
2）在项目目录运行：docker compose up -d（有 compose 的话）。
3）访问本地服务，遇到问题先看容器日志：docker logs -f <容器名>。
