Docker Desktop在Windows上卡顿的根源是WSL2默认内存无上限（可达物理内存50%–80%且不释放），需通过手动创建并配置%USERPROFILE%.wslconfig文件（如memory=6GB）并执行wsl --shutdown彻底重启才能生效，GUI内存滑块对WSL2无效。

Docker Desktop 在 Windows 上卡顿、风扇狂转，根本不是容器没设 -m，而是 WSL2 虚拟机本身没设上限——它默认能吃掉你物理内存的 50% 甚至 80%，且不主动释放。

为什么改 Docker Desktop 设置里的 Memory 滑块不管用？

Windows 版 Docker Desktop 的 GUI 设置（Settings → Resources → Advanced）里调内存滑块，只影响旧版 Hyper-V 后端；现在默认启用 WSL2，GUI 设置对 WSL2 内存限制基本无效。你拖到 8GB，vmmem 进程照样飙到 12GB+，因为 WSL2 根本没读那个值。

• WSL2 的资源策略由 .wslconfig 文件控制，Docker Desktop GUI 不会写入或覆盖它
• 即使你在 GUI 里改了，重启后 WSL2 仍按自己规则分配内存
• 验证方式：任务管理器里看 vmmem 进程实际占用，而非 Docker Desktop 状态栏显示的“Memory usage”

怎么正确创建并配置 .wslconfig？

必须手动在用户目录下建文件，路径是 C:Users\.wslconfig，不能带 .txt 后缀，否则 WSL2 完全忽略。

• 用 PowerShell 一键打开记事本：notepad $env:USERPROFILE.wslconfig（若提示“文件不存在”，点确定新建）
• 粘贴配置，例如 16GB 内存机器推荐：

  [wsl2]
  memory=6GB
  processors=4
  swap=2GB
  localhostForwarding=true

• memory 值建议设为物理内存的 40%–50%，processors 别超物理核心数（非逻辑线程数）
• 保存后务必检查文件属性——扩展名必须是空的，图标不能带小纸片（那是 .txt）

配置完为什么还是没生效？

WSL2 不会热加载 .wslconfig，必须彻底终止所有 WSL 实例，否则旧配置一直跑着。

Docker Encyclopedia

Docker 文档优先工作流：针对 Docker 特定问题、故障排除、命令规划、镜像/构建、容器/运行时操作及 Compose 等

下载

• 在 PowerShell 中执行：wsl --shutdown（注意：不是 wsl -t 或 docker system prune）
• 右键任务栏 Docker 图标 → Exit，确保 Docker Desktop 进程完全退出
• 重新启动 Docker Desktop，此时它才会拉起一个按新 .wslconfig 启动的 WSL2 实例
• 验证是否生效：wsl -l -v 看状态是否为 Running，再进 Ubuntu 执行 free -h，total 行应接近你设的 memory 值

单个容器还要不要加 -m？

要，但只是第二层保险。WSL2 是总池，容器 -m 是池子里的分隔间——没有总池限制，-m 再严也没用。

• 比如 WSL2 设了 memory=8GB，你给 MySQL 容器加 -m 4g，它最多用 4GB，但整个 WSL2 还是能占满 8GB
• 若不设 WSL2 上限，MySQL + Redis + Spring Boot 容器各自 -m 2g，加起来才 6GB，但 WSL2 自己可能因缓存、内核开销吃掉 10GB+
• 生产级组合建议：.wslconfig 控总上限 + docker run -m 或 mem_limit 控单容器硬限 + JVM 容器额外配 -Xmx 防堆溢出

最容易被忽略的是：WSL2 的 swap 和 pageReporting 会影响响应速度。设了 swap=2GB 却没加 pageReporting=false，内存稍紧时系统会频繁换页，磁盘 I/O 暴涨，比单纯内存少更卡。这行不写，swap 就是双刃剑。