WSL2配置不生效 添加.wslconfig后Vmmem进程仍超出内存限制

1. 验证配置文件正确性 #

• 确认文件路径：必须放在Windows用户主目录根路径%USERPROFILE%（通常为C:\Users\你的用户名\），不要存放在WSL内部文件系统或用户主目录的子文件夹中
• 确认文件名：严格命名为.wslconfig，不要带.txt后缀。可在资源管理器顶部「查看」栏勾选「文件扩展名」，避免系统自动隐藏后缀导致实际存为.wslconfig.txt
• 确认文件内容：你使用的配置格式本身无误，注意方括号必须为英文符号，参数行不要加多余空格，文件编码选择UTF-8，不要使用UTF-16等其他编码

2. 确认WSL版本为WSL2 #

.wslconfig配置仅对WSL2生效，WSL1无法识别该配置。
在PowerShell中执行以下命令查看版本：
wsl -l -v
如果正在使用的发行版VERSION列显示为1，执行以下命令转换为WSL2：
wsl --set-version <你的发行版名称> 2

3. 验证配置是否已经加载 #

执行wsl --shutdown等待10秒后再启动WSL，进入WSL终端后执行free -h，查看Mem行的总容量是否和你设置的2GB一致：

• 如果总容量符合设置：Vmmem进程占用超出几百MB属于正常情况，这部分是WSL2虚拟机的底层管理开销，不属于配置不生效
• 如果总容量不符合设置：继续向下排查

4. 排查WSL版本和实例问题 #

• 执行wsl --list --running确认所有运行中的WSL实例都已经关闭，不存在其他后台运行的发行版占用资源
• 执行wsl --update升级WSL到最新版本，旧版本WSL存在配置不加载的已知bug，升级后重新执行wsl --shutdown生效

5. 排查WSL内部进程占用 #

如果配置已经生效（free -h显示总内存为2GB）但Vmmem占用过高，进入WSL执行top命令，查看内部运行的进程内存占用，确认是不是业务进程本身的内存消耗过高导致占用接近上限。
另外你设置了swap=0，内存占满后会直接触发OOM杀进程，如果有需要可以适当调整swap配置降低OOM概率。

内容的提问来源于stack exchange，提问作者Dor Gross