Win11上Docker Desktop因WSL2默认内存无限制（可达物理内存50%且不释放）导致卡顿，需通过创建.wslconfig文件配置memory、processors等参数并执行wsl --shutdown重启生效。
Win11上Docker Desktop默认会无节制占用系统内存，尤其在WSL2后端下常吃掉12GB以上，导致Chrome、IDE等应用频繁卡顿甚至崩溃。这不是配置没生效，而是WSL2虚拟机根本没被设限——它默认按物理内存50%动态分配，且不释放空闲内存。
创建并配置 .wslconfig 限制资源上限
第一步：用 PowerShell 创建配置文件
以管理员身份运行 PowerShell，执行：notepad $env:USERPROFILE\.wslconfig
第二步：粘贴以下内容（请根据你的真实内存大小调整）
[wsl2]<br>memory=8GB<br>processors=4<br>swap=2GB<br>localhostForwarding=true
第三步：保存并关闭记事本
【必须确认文件名是 .wslconfig，不是 .wslconfig.txt】——记事本默认加.txt后缀，若看到蓝色“已保存”但文件图标带小纸片，说明扩展名错了，需重命名并勾选“显示文件扩展名”手动删掉.txt。
第四步：彻底重启 WSL2
在 PowerShell 中运行：wsl --shutdown
然后关闭 Docker Desktop 图标（右键任务栏→退出），再重新启动 Docker Desktop。此时新配置才会加载。
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。
验证配置是否生效
方法一：检查 WSL2 实际内存占用
启动任意一个 Linux 发行版（如 Ubuntu），运行：free -h
输出中的 total 行 memory 值应接近你设置的 8GB，而非原始物理内存的一半。
方法二：查看 Docker Desktop 底部状态栏
鼠标悬停在右下角 Docker 图标上，弹出提示中显示的“Memory usage”数值应在 7–9GB 区间浮动，不再持续攀升至 10GB+。
进阶调优：针对高负载开发场景
如果你同时跑数据库+前端+后端容器，且机器有32GB内存，可改用以下配置：
[wsl2]<br>memory=14GB<br>processors=6<br>swap=4GB<br>kernelCommandLine = sysctl.vm.swappiness=10
其中 sysctl.vm.swappiness=10 是关键：它大幅降低内核交换倾向，避免 WSL2 在内存稍紧时就疯狂写入 swap 文件拖慢 I/O。不加这行，swap=4GB 反而可能引发磁盘抖动。
改完配置后仍需执行 wsl --shutdown 才能生效。
