wslg (WSL GUI) nie działa

WSLg (graficzny interfejs dla aplikacji Linuksa w WSL) niedziałający zwykle wskazuje na nieaktualne jądro WSL — wymaga aktualizacji poleceniem `wsl --update` do wersji z wbudowanym wsparciem WSLg.

Czym jest problem „wslg (WSL GUI) nie działa”

WSLg to warstwa środowiska Windows Subsystem for Linux, która umożliwia uruchamianie aplikacji z graficznym interfejsem Linuksa bez instalowania pełnej, osobnej maszyny wirtualnej. Dzięki niej programy korzystające z okien, menu, pól formularzy czy akceleracji obrazu mogą być wyświetlane bezpośrednio na pulpicie Windows. Gdy pojawia się komunikat, że WSLg nie działa, aplikacja może nie uruchamiać się wcale, otwierać się bez widocznego okna albo kończyć pracę zaraz po starcie.

Nie jest to jeden konkretny błąd, lecz określenie grupy problemów związanych z komunikacją pomiędzy dystrybucją Linuksa, komponentem WSL, usługami graficznymi oraz systemem Windows. W praktyce usterka może dotyczyć zarówno samej konfiguracji środowiska, jak i aktualizacji jego elementów. WSLg korzysta z komponentów dostarczanych razem z nowszymi wydaniami WSL, dlatego starsza instalacja może obsługiwać polecenia Linuksa poprawnie, a jednocześnie nie zapewniać prawidłowego działania aplikacji okienkowych.

Warto odróżnić ten problem od sytuacji, w której nie działa pojedynczy program linuksowy. Jeżeli polecenie tekstowe wykonuje się w terminalu, ale aplikacja graficzna nie tworzy okna, podejrzenie pada na WSLg, zmienną środowiskową wyświetlania albo warstwę integracji z pulpitem Windows. Jeżeli natomiast nie uruchamia się również sama dystrybucja, potrzebne może być sprawdzenie stanu całego WSL, a nie tylko jego części graficznej.

Kontekst techniczny i porównanie sposobów uruchamiania Linuksa

Klasyczna praca z WSL odbywa się w terminalu. Program otrzymuje wejście tekstowe i zwraca wynik w konsoli, więc do działania nie potrzebuje serwera wyświetlania ani mechanizmu tworzenia okien. WSLg rozszerza ten model o obsługę aplikacji graficznych. W uproszczeniu uczestniczą w tym: jądro i narzędzia WSL, wybrana dystrybucja Linuksa, komponenty WSLg oraz elementy systemu Windows odpowiedzialne za wyświetlanie obrazu i dźwięku.

Różnica względem pełnej maszyny wirtualnej polega na sposobie integracji. W przypadku WSLg aplikacja linuksowa może pojawić się obok programów Windows, korzystając z mechanizmów udostępnionych przez środowisko WSL. Nie oznacza to jednak, że każda aplikacja graficzna będzie działała bez dodatkowej konfiguracji. Program może wymagać określonych bibliotek, sterownika graficznego, poprawnie ustawionej zmiennej DISPLAY albo WAYLAND_DISPLAY, a także zgodności z używanym systemem okien.

Pierwszym krokiem diagnostycznym jest sprawdzenie wersji oraz stanu WSL poleceniami takimi jak wsl --status i wsl --version. Następnie można wykonać wsl --update, aby pobrać aktualne składniki środowiska. Po aktualizacji przydatne bywa zatrzymanie uruchomionych dystrybucji poleceniem wsl --shutdown i ponowne uruchomienie wybranej dystrybucji. Takie działanie odświeża procesy WSL, ale nie usuwa plików użytkownika ani zainstalowanych pakietów.

W razie potrzeby należy także sprawdzić, czy używana dystrybucja działa w wersji WSL 2. Można to zweryfikować za pomocą wsl -l -v. W przypadku aplikacji graficznych ważne jest również, aby system Windows był aktualny i aby sterownik układu graficznego nie był uszkodzony lub niezgodny z bieżącą konfiguracją. Aktualizacja WSL nie zawsze rozwiąże problem, jeśli przyczyną jest brak biblioteki wewnątrz dystrybucji, błędny profil powłoki albo ograniczenie konkretnego programu.

Typowe problemy, błędy i objawy - wslg (WSL GUI) nie działa

Częstym powodem jest nieaktualny pakiet WSL. W starszych instalacjach może brakować elementów potrzebnych do obsługi aplikacji graficznych, dlatego polecenia terminalowe działają, lecz programy z interfejsem okienkowym nie mogą nawiązać połączenia z warstwą wyświetlania. W takiej sytuacji aktualizacja przez wsl --update, ponowne uruchomienie WSL i kontrola wersji dystrybucji są podstawowymi czynnościami.

Inny scenariusz występuje po zmianie plików konfiguracyjnych, na przykład ~/.bashrc, ~/.profile lub ustawień powłoki. Ręcznie nadpisane zmienne środowiskowe mogą kierować aplikację do nieistniejącego serwera wyświetlania. Objawem może być komunikat w rodzaju cannot open display, Failed to connect to Wayland albo brak reakcji po wpisaniu polecenia uruchamiającego aplikację. Warto wtedy porównać środowisko nowej sesji z ustawieniami zapisanymi w plikach startowych i usunąć nieaktualne wpisy, zamiast dodawać kolejne wartości na ślepo.

Problemy mogą być również związane z konkretną aplikacją. Niektóre programy wymagają dodatkowych bibliotek graficznych, określonego backendu renderowania lub pakietów instalowanych wewnątrz dystrybucji. Jeżeli jedna aplikacja nie działa, a inne programy okienkowe uruchamiają się prawidłowo, bardziej prawdopodobna jest niezgodność lub brak zależności po stronie programu. Należy sprawdzić komunikat błędu uruchomienia, logi systemowe oraz sposób instalacji aplikacji.

Brak obrazu może wynikać ze sterownika graficznego Windows, konfliktu po aktualizacji albo działania oprogramowania zabezpieczającego, które ogranicza komunikację pomiędzy procesami. Warto również sprawdzić, czy aplikacja nie została uruchomiona z podwyższonymi uprawnieniami w sposób, który zmienia jej środowisko. Podobne objawy mogą pojawić się przy korzystaniu z połączenia zdalnego, gdy sesja nie udostępnia wszystkich funkcji graficznych.

Jeżeli WSLg uruchamia okno, lecz nie działa dźwięk, nie należy automatycznie uznawać całego środowiska za niesprawne. Obraz i dźwięk korzystają z odrębnych mechanizmów, a przyczyna może znajdować się w konfiguracji systemu Windows, wybranym urządzeniu wyjściowym lub ustawieniach samej aplikacji. Z kolei powtarzające się zamykanie środowiska, błędy usług systemowych albo problemy po każdej aktualizacji wymagają szerszej kontroli, obejmującej logi, wersje składników oraz stan plików systemowych.

W jakich sytuacjach warto przekazać urządzenie do naprawy - wslg (WSL GUI) nie działa

Samodzielna aktualizacja WSL jest zwykle bezpieczna, lecz przed zmianami warto zachować ważne pliki z dystrybucji i zanotować dotychczasową konfigurację. Do serwisu warto zgłosić się wtedy, gdy problem wystąpił po aktualizacji systemu, dotyczy kilku aplikacji, powraca po restarcie albo towarzyszą mu inne objawy, takie jak zawieszanie WSL, błędy sterownika graficznego czy nieprawidłowe działanie programów Windows. Szczególnej uwagi wymaga sytuacja, w której środowisko jest używane do pracy, a kolejne próby naprawy mogą zmienić konfigurację lub utrudnić dostęp do danych.

W ramach diagnostyki można sprawdzić wersję WSL, stan dystrybucji, sposób uruchamiania aplikacji, komunikaty błędów, pliki konfiguracyjne oraz zależności wymagane przez konkretny program. Następnie można rozdzielić problem komponentu WSLg od problemu samej dystrybucji, sterownika graficznego albo aplikacji linuksowej. Takie podejście ogranicza ryzyko przypadkowego usunięcia środowiska i ułatwia dobranie naprawy do rzeczywistej przyczyny.

W Warszawie pomoc przy tego rodzaju usterkach można zlecić serwisowi „Warszawskie Pogotowie Komputerowe 24/7”, gdzie naprawy trwają z reguły do 3 dni roboczych. Przed przekazaniem urządzenia warto przygotować nazwę używanej dystrybucji, wynik poleceń wsl --status oraz wsl -l -v, dokładny komunikat pojawiający się przy uruchamianiu programu i informację, czy problem dotyczy wszystkich aplikacji graficznych, czy tylko jednej. Ułatwia to odtworzenie błędu i sprawdzenie, czy po wykonanych czynnościach WSLg działa poprawnie także po ponownym uruchomieniu komputera.