Win11下通过WSL2调整Docker内存失败,求助排查方法
解决WSL2 Docker内存配置不生效的问题
核心问题
你创建的.wslconfig实际是.wslconfig.txt,Windows默认隐藏已知文件后缀,导致系统无法识别这个配置文件,所以内存调整始终不生效。
修复步骤
- 显示文件后缀名
- 打开文件资源管理器,点击顶部「查看」选项卡,勾选「文件扩展名」。此时你会看到目标文件的真实名称是
wslconfig.txt。
- 打开文件资源管理器,点击顶部「查看」选项卡,勾选「文件扩展名」。此时你会看到目标文件的真实名称是
- 修改文件名
- 右键重命名该文件,删除后缀
.txt,确保最终文件名为.wslconfig(注意开头的英文点号不能省略)。 - 系统弹出「更改文件扩展名可能会导致文件不可用」的提示时,点击「是」确认。
- 右键重命名该文件,删除后缀
- 确认配置内容格式
打开.wslconfig,确保配置项放在[wsl2]区块下,以设置14GB内存为例,内容如下:[wsl2] memory=14GB - 重启相关服务
- 打开PowerShell或命令提示符,执行命令重启WSL:
wsl --shutdown - 关闭Docker Desktop后重新启动。
- 打开PowerShell或命令提示符,执行命令重启WSL:
- 验证配置效果
- 打开Docker Desktop,进入「设置」>「资源」>「WSL集成」,查看内存分配是否更新为14GB;
- 也可以在WSL终端执行
free -h命令,查看可用内存是否符合预期。
额外注意事项
.wslconfig必须放在Windows用户目录下(路径为C:\Users\<你的用户名>\.wslconfig),位置错误会导致配置不生效。- 确认Docker设置中已开启「使用WSL 2基于的引擎」,如果是Hyper-V后端,需要在Docker自身的资源设置里调整内存。
内容的提问来源于stack exchange,提问作者Josue Criollo
相关产品推荐
相关产品推荐

