Как настроить maxCrashDumpCount в .wslconfig

Что ограничивает maxCrashDumpCount

Microsoft относит `maxCrashDumpCount` к расширенным параметрам `.wslconfig` для WSL 2. Число задаёт максимальное количество crash dump файлов, сохраняемых для отладки; стандартное значение — 10, а при превышении старые дампы удаляются. Параметр не ускоряет Linux и не устраняет первопричину падений — он лишь ограничивает объём диагностических файлов.

Совет: Перед правкой сохраните копию `.wslconfig`: одна опечатка в общем файле может затронуть все WSL 2-дистрибутивы.

Редактирование .wslconfig и перезапуск WSL

1. Откройте `%UserProfile%\.wslconfig` в обычном текстовом редакторе; если файла нет, создайте его с таким именем без `.txt`.
2. Добавьте секцию `[wsl2]`, если её ещё нет, и строку `maxCrashDumpCount=5` или другое осмысленное целое значение.
3. Сохраните файл, не создавая вторую конфликтующую секцию `[wsl2]` ниже по документу.
4. Закройте работающие задачи Linux и выполните в PowerShell `wsl --shutdown`, чтобы глобальная VM завершилась.
5. Запустите WSL снова и при следующей диагностике контролируйте число дампов; отсутствие новых файлов без крашей нормально.

Предупреждение: Снижение лимита дампов не является исправлением падений WSL — сохраняйте хотя бы несколько файлов, если ведёте диагностику.

Проверка параметра без удаления дампов

• Файл называется именно `.wslconfig` и лежит в профиле Windows-пользователя.
• Параметр находится в секции `[wsl2]`.
• После редактирования был выполнен полный `wsl --shutdown`.
• Лимит выбран так, чтобы не уничтожать нужную историю диагностики слишком рано.

Важно: Критерий результата: WSL после перезапуска использует заданный лимит дампов, а остальные параметры `.wslconfig` продолжают применяться без синтаксических конфликтов.

Почему это не средство ускорения WSL

Не ставьте нулевое или минимальное значение просто ради экономии места, если вы расследуете нестабильность: без достаточного числа дампов сравнивать повторяющиеся сбои сложнее. Если `.wslconfig` уже содержит memory, swap или network-параметры, редактируйте существующую секцию аккуратно. Для постоянного роста диска сначала выясните, действительно ли место занимают crash dumps. Значение задаётся глобально для виртуальной машины WSL 2, поэтому изменение затронет не один дистрибутив. Перед правкой сохраните копию текущего `.wslconfig`, особенно если там уже настроены memory, processors, swap или networkingMode. После редактирования используйте `wsl --shutdown`, потому что простое закрытие окна Linux не гарантирует пересоздание VM. Если цель — освободить диск, сначала подтвердите, что место действительно занимают crash dump, а не VHDX дистрибутива или Docker.

Как оценить эффект настройки

После `wsl --shutdown` и нового запуска убедитесь, что `.wslconfig` не содержит дублирующей секции `[wsl2]` и параметр записан как целое число. Эффект настройки проявится только при появлении новых crash dump: WSL будет удерживать не больше заданного количества, удаляя старые. Если дисковое пространство продолжает быстро исчезать, ищите другой источник роста. Сам параметр не создаёт дампы и не включает диагностику — он только задаёт верхнюю границу их количества при наличии сбоев.

Что учитывать

Microsoft относит `maxCrashDumpCount` к расширенным параметрам `.wslconfig` для WSL 2. Число задаёт максимальное количество crash dump файлов, сохраняемых для отладки; стандартное значение — 10, а при превышении старые дампы удаляются. Параметр не ускоряет Linux и не устраняет первопричину падений — он лишь ограничивает объём диагностических файлов.

Источники и проверка

Фактическая часть сверена по первичным источникам (в т.ч. Advanced settings configuration in WSL). Пример и формулировки — редакция N1RO на 2026-09-22.

• Advanced settings configuration in WSL