因为Docker Desktop界面的Swap滑块仅控制容器级--memory-swap参数，不影响WSL2虚拟机的交换空间；真正生效的是%UserProfile%.wslconfig中配置的swap值，且需quit Docker Desktop并执行wsl --shutdown后重启才生效。
为什么改 swap 不能只动 Docker Desktop 界面
Docker Desktop 的图形界面里只有 Memory 和 Swap 两个滑块，但那个 Swap 滑块实际控制的是容器级的 --memory-swap 参数，和 WSL2 底层虚拟机的交换空间完全不是一回事。你调它，只影响单个容器能否使用 swap，对 vmmem 进程吃掉的系统内存毫无作用。真正决定 Docker Desktop 整体 swap 行为的，是 WSL2 的 .wslconfig 文件里的 swap 配置项。
.wslconfig 里怎么配 swap
在 C:\Users\你的用户名\.wslconfig 中添加或修改 [wsl2] 区块：
-
swap=4GB：这是最常用写法，表示 WSL2 虚拟机最多可用 4GB 交换空间；数值建议不超过物理内存的 30%，比如你有 32GB 内存，设到 8GB 就偏高了，容易拖慢磁盘 I/O -
swap=0：彻底禁用 swap，适合 SSD 性能强、内存充足（≥24GB）且跑稳定服务的场景；但一旦memory耗尽，WSL2 会直接 OOM 崩溃，不是优雅降级 - 不写
swap行：WSL2 默认启用 swap，大小为物理内存的 25%，这个值在大内存机器上往往过大（如 32GB 主机默认 8GB），极易引发卡顿 -
swapfile=C:\wsl\swap.vhdx：可指定 swap 文件位置，避免放在系统盘（C:\）导致碎片或空间不足；路径需提前创建好目录，且确保有写入权限
改完 swap 为什么没生效
常见失效原因全是操作链断点：
- 没完全退出 Docker Desktop：右键托盘图标选 “Quit Docker Desktop”，不是关窗口，也不是“Restart”
- 没执行
wsl --shutdown：仅靠重启 Docker Desktop 不会重载.wslconfig，必须手动终止所有 WSL2 实例 - 文件名错了：记事本保存时默认加
.txt后缀，必须确认文件真实名称是.wslconfig，不是.wslconfig.txt - 配置位置错了：必须放在当前 Windows 用户目录下，不是 Docker 安装目录，也不是 WSL 发行版内部的 home 目录
- 没验证是否加载：运行
wsl -l -v看状态是Stopped后，再启动 Docker Desktop，然后进任意 WSL 发行版执行free -h，观察Swap:行数值是否匹配你设的swap值
swap 和 memory 的联动关系
WSL2 的内存与 swap 是绑定管理的，不是独立开关：
- 如果设了
memory=6GB但没设swap，WSL2 仍会按默认规则分配 swap（如 25% 物理内存），可能远超你需要 - 如果设了
swap=2GB但memory=8GB，那总可用虚拟内存就是 10GB；但 swap 是磁盘-backed 的，频繁使用会明显拖慢构建、拉镜像等 I/O 密集操作 - SSD 用户可以适当提高
swap（如 4–6GB），机械硬盘用户建议压低到 1–2GB 或直接设为 0 - 开发中频繁启停容器时，
swap偏高反而增加冷启动延迟，因为 WSL2 需从磁盘恢复页；长期运行 CI/CD 服务则可略宽松
真正起效的永远是 .wslconfig 里的 swap，而不是界面上那个同名滑块——后者只是个误导性 UI 元素，连文档都没提它实际管什么。
