Текст и данные · Инструкция
WSL debugConsoleLogFile: как сохранить вывод консоли ядра в файл
Настройка WSL debugConsoleLogFile полезна в узком сценарии: сбой происходит во время старта и консольный вывод нужно сохранить. Параметр `debugConsoleLogFile` задаёт Windows-файл, куда дописывается вывод консоли Linux-ядра. Перед правкой сохраните прежнее значение, чтобы откат был однозначным.
Короткий ответ
В `%UserProfile%\.wslconfig` задайте `debugConsoleLogFile=C:\\WSL\\kernel-console.log`, затем выполните `wsl --shutdown` и снова запустите WSL. Файл дописывается и со временем растёт.
Что делает `debugConsoleLogFile` в WSL 2
`debugConsoleLogFile` относится к глобальным настройкам WSL 2. Задаёт windows-файл, куда дописывается вывод консоли linux-ядра. Это не то же самое, что `/etc/wsl.conf`: тот файл относится к отдельному дистрибутиву, а `.wslconfig` лежит в профиле Windows. Практический смысл настройки появляется, когда сбой происходит во время старта и консольный вывод нужно сохранить. Если измеримого симптома нет, значение по умолчанию обычно лучше дополнительной нестандартной переменной. Перед изменением запишите текущее состояние и тест, по которому будете сравнивать результат.
Совет: Сохраните копию `.wslconfig` и меняйте один ключ за раз. Так проще понять, что именно повлияло на систему.
Как задать `debugConsoleLogFile` и применить конфигурацию
- Откройте PowerShell и выполните `notepad $env:USERPROFILE\.wslconfig`; если файла нет, создайте его без расширения `.txt`.
- В секции `[wsl2]` добавьте `debugConsoleLogFile=C:\\WSL\\kernel-console.log`. Если `debugConsoleLogFile` уже есть, измените существующую строку, а не создавайте дубликат.
- Сохраните файл и закройте работающие Linux-процессы, чтобы не потерять несохранённую работу.
- В Windows выполните `wsl --shutdown`. Простого закрытия окна терминала недостаточно, потому что VM может продолжать работать.
- Запустите дистрибутив снова и проверьте результат: после нового запуска откройте целевой Windows-файл и проверьте появление свежих строк ядра.
Предупреждение: Файл дописывается и со временем растёт. Если результат ухудшился, верните прежнее значение, снова выполните `wsl --shutdown` и повторите исходный тест.
Как проверить эффект `debugConsoleLogFile` после перезапуска
Не меняйте одновременно память, сеть, ядро и `debugConsoleLogFile`. Сначала воспроизведите проблему, зафиксируйте результат, затем примените только эту правку. После перезапуска выполните тот же сценарий: проверить новые строки в лог-файле после запуска. Если улучшение не повторяется, причина может быть в службе дистрибутива, Windows-драйвере, VPN, файловой системе или другой части стека. Возврат к дефолту уменьшит число переменных и упростит следующую диагностику. Для длительного использования оставляйте параметр только при устойчивом, понятном результате.
Важно: Критерий успеха должен быть измеримым: время старта, число CPU, доступность сети, наличие модуля или созданный лог, а не ощущение «стало лучше».
Что зафиксировать до изменения `debugConsoleLogFile`
Перед правкой выполните `wsl -l -v` и запишите исходное поведение. Для `debugConsoleLogFile` важно иметь один повторяемый тест: после нового запуска откройте целевой Windows-файл и проверьте появление свежих строк ядра. Это позволит сравнить состояние до и после, а не оценивать изменение по общему впечатлению.
Как откатить `debugConsoleLogFile` без переустановки дистрибутива
Верните прежнюю строку или удалите явный `debugConsoleLogFile`, сохраните `.wslconfig` и выполните `wsl --shutdown`. После нового запуска WSL снова применит значение по умолчанию: не задан. Файлы Linux при таком откате не удаляются.
Какая ошибка чаще всего мешает проверить `debugConsoleLogFile`
Не меняйте одновременно соседние параметры `.wslconfig`. Если вместе с `debugConsoleLogFile` изменить сеть, память или ядро, источник эффекта потеряется. Сначала меняйте только этот ключ, затем повторяйте тот же тест: после нового запуска откройте целевой Windows-файл и проверьте появление свежих строк ядра.
Когда оставить `debugConsoleLogFile`, а когда откатить
- `.wslconfig` находится в `%UserProfile%` Windows
- настройка относится к WSL 2, а не WSL 1
- после изменения выполнен `wsl --shutdown`
- проверена именно исходная задача, а не случайный соседний симптом
- старое значение сохранено для быстрого отката
Что учитывать
Условия меняются. Страница отражает состояние на 2026-09-23; при расхождении с официальной документацией приоритет у первоисточника.
Источники и проверка
Фактическая часть сверена по первичным источникам (в т.ч. Advanced settings configuration in WSL). Пример и формулировки — редакция N1RO на 2026-09-23.