Ошибки и коды · Инструкция
WSL .wslconfig не применяется после изменения: что проверить
WSL .wslconfig не применяется после изменения: что проверить. Файл должен находиться в `%UserProfile%\.
Короткий ответ
Изменения %UserProfile%\.wslconfig применяются только после полного завершения WSL 2 VM. Сохраните файл в правильном профиле Windows, выполните wsl --shutdown и запустите дистрибутив заново.
Как проверить без лишних изменений
- Проверьте путь файла: %UserProfile%\.wslconfig, а не папка Linux и не случайный другой Windows-профиль.
- Проверьте синтаксис секций и имя параметра по актуальной таблице Microsoft; неизвестные или неправильно размещенные ключи не дадут ожидаемого эффекта.
- Закройте важные процессы WSL и сохраните данные.
- В PowerShell выполните wsl --shutdown и убедитесь, что после этого вы заново запускаете дистрибутив.
- Проверьте конкретный эффект настройки: память, сеть, kernelCommandLine или другой параметр — подходящим для него способом.
Предупреждение: Microsoft отмечает «правило примерно 8 секунд», но `wsl --shutdown` быстрее и однозначнее завершает WSL 2 VM.
Когда WSL перечитывает .wslconfig
Microsoft предупреждает, что WSL должен полностью остановиться, прежде чем изменения глобальной конфигурации вступят в силу. Команда wsl --shutdown немедленно завершает все дистрибутивы и WSL 2 utility VM, поэтому это надежнее простого закрытия окна терминала.wslconfig относится к глобальной конфигурации WSL 2 и должен находиться в каталоге профиля Windows, а /etc/wsl.conf — внутри конкретного Linux-дистрибутива. В случае «WSL .wslconfig не применяется после изменения: что проверить» сначала зафиксируйте текущую версию WSL и рабочую конфигурацию, затем применяйте документированный шаг и проверяйте его эффект. В сценарии «WSL .wslconfig не применяется после изменения: что проверить» откат должен быть понятен до выполнения команды, особенно если действие останавливает VM, меняет сеть, ядро или файловую систему.
Совет: Не путайте `.wslconfig` в профиле Windows с `/etc/wsl.conf` внутри Linux: у них разные области действия.
Контрольные условия
- Файл находится в %UserProfile%
- Параметр поддерживается вашей версией WSL
- Выполнен полный wsl --shutdown
- Проверяется именно эффект нужного ключа
Что не стоит делать
Некоторые параметры имеют ограничения по версии Windows/WSL или игнорируются в определенном networking mode; например localhostForwarding не используется в mirrored mode. Не удаляйте рабочий .wslconfig целиком при первой ошибке: временно закомментируйте подозрительный ключ и меняйте по одному параметру.
Важно: Некоторые параметры зависят от версии WSL или режима сети; например, `localhostForwarding` игнорируется при mirrored networking.
Пример контрольной проверки
Контроль для «WSL .wslconfig не применяется после изменения: что проверить»: подтвердите «файл находится в %userprofile%», затем выполните первый шаг — проверьте путь файла: %UserProfile%\.wslconfig, а не папка Linux и не случайный другой Windows-профиль.
Проверка по признакам
- файл находится в %UserProfile%. Проверка «файл находится в %userprofile%» подтверждает исходное состояние перед изменением WSL.
- параметр поддерживается вашей версией WSL. Пункт «параметр поддерживается вашей версией wsl» локализует проблему и не дает менять несколько причин одновременно.
- выполнен полный wsl --shutdown. Условие «выполнен полный wsl --shutdown» позволяет проверить команду или настройку на конкретном уровне.
- проверяется именно эффект нужного ключа. Если выполнено «проверяется именно эффект нужного ключа», следующий шаг можно оценивать без догадок о предыдущем.
Что учитывать
Условия меняются. Страница отражает состояние на 2026-09-22; при расхождении с официальной документацией приоритет у первоисточника.
Источники и проверка
Фактическая часть сверена по первичным источникам (в т.ч. Advanced settings configuration in WSL). Пример и формулировки — редакция N1RO на 2026-09-22.