#Что означает сообщение
WSLg чёрное окно
WSLg запускает графические Linux-приложения в окружении WSL 2; чёрное окно может быть связано с драйвером GPU, WSLg или переменными окружения.
#Как отличить причины
| Возможная причина | Как узнать | Что делать |
|---|---|---|
| WSL | Команда wsl показывает ошибку запуска или неправильную версию дистрибутива | Проверьте wsl --status и wsl --list --verbose, затем обновите WSL. |
| Драйвер | Сбой возник после установки видеодрайвера | Установите официальный драйвер Windows с поддержкой WSLg. |
| Конфликт | Сторонние настройки DISPLAY/WAYLAND конфликтуют с WSLg | Проверьте переменные внутри Linux без удаления окружения. |
| Ресурсы | Графический ускоритель и память перегружены | Закройте тяжёлые процессы, проверьте систему и сохраните проект перед wsl --shutdown. |
#Пошаговое решение
- Зафиксируйте ошибку и проверьте условияУточните, что именно не работает: окно Linux-приложения чёрное, приложение не стартует или ошибка только при графическом ускорении. Откройте PowerShell/Терминал Windows и выполните
wsl --status, затемwsl --list --verbose. Убедитесь, что нужный дистрибутив работает как WSL2 и Windows 11 обновлена штатно. Не удаляйте дистрибутив для диагностики: в нём могут храниться важные файлы. - Выполните основную проверку и исправлениеПроверьте, установлен ли для видеокарты драйвер Windows с поддержкой WSL2/WSLg: нажмите Win+X → «Диспетчер устройств → Видеоадаптеры» → «Свойства → Драйвер», запишите модель и версию. Загрузите совместимый драйвер только с официального сайта изготовителя ПК или GPU, учитывая инструкции Microsoft для WSLg. После установки перезагрузитесь. Не устанавливайте обычный Linux-драйвер NVIDIA внутри WSL в качестве первого решения.
- Исключите другие подтверждённые причиныВ PowerShell выполните
wsl --update, дождитесь сообщения об обновлении и затемwsl --shutdown, понимая, что в этот момент завершатся все работающие дистрибутивы и несохранённые процессы. Сначала сохраните проекты и закройте Linux-приложения. Затем снова запустите дистрибутив и попробуйте простое графическое приложение, установленное из его штатного репозитория. Если обновление не удаётся, запишите точную ошибку и не удаляйте WSL. - Проверьте, действительно ли проблема решенаЕсли окно остаётся чёрным, внутри Linux выполните
echo $WAYLAND_DISPLAYиecho $DISPLAY: отсутствие обоих значений может указывать на сбой инициализации графической среды, но не является единственным диагнозом. Проверьте тот же дистрибутив без сторонних настроек переменных окружения и сохраните выводwsl --status, сборку Windows и версию драйвера GPU. Не удаляйте/mnt/wslgи не запускайтеwsl --unregister: последнее уничтожит данные дистрибутива.
#Что важно перед исправлением
Не удаляйте Linux-дистрибутив ради исправления окна: это может уничтожить его файловую систему. Перед сбросом сделайте wsl --export.