wsl nie działa z wt.exe

WSL niedziałający poprawnie z Terminalem Windows (wt.exe) zwykle wskazuje na nieaktualną wersję Terminala lub konflikt profilu automatycznie generowanego dla dystrybucji WSL.

Wsl nie działa z wt.exe – co oznacza ten problem

Komunikat lub sytuacja opisywana jako „wsl nie działa z wt.exe” oznacza, że środowisko Windows Subsystem for Linux nie uruchamia się prawidłowo z poziomu aplikacji Windows Terminal albo że Terminal nie potrafi poprawnie wyświetlić dostępnej dystrybucji Linuksa. Polecenie wsl odpowiada za uruchamianie i obsługę warstwy Linux w systemie Windows, natomiast wt.exe jest plikiem wykonywalnym odpowiedzialnym za otwieranie Windows Terminal. Są to dwa powiązane, ale odrębne składniki systemu. Awaria jednego z nich nie musi oznaczać uszkodzenia samej dystrybucji.

Problem może objawiać się otwarciem pustej karty, natychmiastowym zamknięciem okna, brakiem dystrybucji na liście profili, komunikatem o nieznanym poleceniu albo uruchomieniem zwykłego wiersza poleceń zamiast powłoki Linuksa. Czasem polecenie działa w PowerShellu, lecz nie działa po kliknięciu profilu w Windows Terminal. W innych przypadkach Terminal uruchamia się poprawnie, ale próba wykonania wsl kończy się błędem dotyczącym składników systemowych, rejestracji dystrybucji lub usługi potrzebnej do obsługi WSL.

Znaczenie ma także sposób zapisu polecenia. wt.exe uruchamia Terminal, a parametry przekazane po nim mogą wskazywać konkretny profil, katalog roboczy lub komendę startową. Samo wsl.exe uruchamia środowisko WSL bez konieczności korzystania z interfejsu Terminala. Takie rozróżnienie pozwala ustalić, czy problem dotyczy programu terminalowego, konfiguracji profilu, czy mechanizmu WSL znajdującego się głębiej w systemie.

Różnica między WSL, Windows Terminal i profilem uruchamiania

Windows Subsystem for Linux tworzy warstwę umożliwiającą korzystanie z dystrybucji Linuksa wewnątrz Windows, bez typowego uruchamiania osobnego komputera wirtualnego. Windows Terminal pełni natomiast rolę graficznego interfejsu, w którym można otwierać wiele powłok, między innymi PowerShell, wiersz poleceń i dystrybucje WSL. Profil Terminala przechowuje informacje o tym, jaki program ma zostać uruchomiony, z jakimi argumentami oraz w jakim katalogu ma rozpocząć pracę.

Jeżeli profil WSL zawiera nieaktualną ścieżkę, błędną nazwę dystrybucji lub parametry niezgodne z bieżącą instalacją, wt.exe może nie otworzyć powłoki mimo prawidłowego działania samego WSL. Odwrotna sytuacja również jest możliwa: dystrybucja może być zainstalowana, lecz Windows Terminal może mieć uszkodzone dane konfiguracyjne albo nie otrzymać poprawnej informacji o dostępnych profilach.

W praktyce warto rozdzielić testy na kilka poziomów. Najpierw sprawdza się, czy Windows reaguje na polecenie wsl --status oraz czy widoczna jest lista dystrybucji po użyciu wsl --list --verbose. Następnie można uruchomić konkretną dystrybucję poleceniem w rodzaju wsl -d NazwaDystrybucji. Jeżeli te działania kończą się powodzeniem, a problem występuje wyłącznie przy wyborze profilu w Terminalu, uwagę należy skierować na konfigurację wt.exe, ustawienia aplikacji i sposób generowania profili.

Znaczenie ma także tryb działania WSL. Wersja pierwsza i wersja druga korzystają z odmiennych mechanizmów, dlatego polecenia diagnostyczne mogą zwracać różne informacje zależnie od ustawienia konkretnej dystrybucji. Nie powinno się zmieniać trybu bez sprawdzenia kopii ważnych danych oraz bez ustalenia, czy używane narzędzia i środowisko programistyczne są z nim zgodne. Samo przełączenie wersji nie stanowi uniwersalnej naprawy problemu z Windows Terminalem.

Typowe przyczyny błędów przy uruchamianiu wsl z wt.exe

Jedną z częstszych przyczyn jest nieaktualna aplikacja Windows Terminal albo niespójność pomiędzy aplikacją a składnikami WSL. Po aktualizacji systemu może zmienić się sposób tworzenia profili, nazwa dystrybucji lub lokalizacja danych konfiguracyjnych. Jeśli aktualizacja została przerwana, aplikacja może uruchamiać się z ustawieniami częściowo zapisanymi, co skutkuje brakiem profilu WSL lub błędem przy otwieraniu nowej karty.

Drugą grupę stanowią problemy z samą dystrybucją. Może ona znajdować się w stanie niepoprawnego zamknięcia, mieć uszkodzony system plików albo nie zostać prawidłowo zarejestrowana w systemie. W takim przypadku Windows Terminal może wyświetlać profil, ale po jego wybraniu nie pojawi się działająca powłoka. Pomocne bywa porównanie wyniku poleceń wykonywanych bezpośrednio w PowerShellu z zachowaniem profilu uruchamianego przez wt.exe.

Wpływ mogą mieć również ustawienia funkcji systemowych, usługi odpowiedzialne za uruchamianie środowiska, ograniczenia konta użytkownika oraz reguły bezpieczeństwa. Zablokowanie procesu pomocniczego, brak wymaganej funkcji systemu lub nieprawidłowe uprawnienia mogą powodować błąd, który na pierwszy rzut oka wygląda jak awaria Windows Terminala. Warto sprawdzić, czy problem dotyczy wszystkich kont użytkowników, czy tylko jednego profilu Windows, ponieważ taka różnica pomaga zawęzić obszar poszukiwań.

Nie należy pochopnie usuwać dystrybucji poleceniem wyrejestrowującym. Operacja tego rodzaju może usunąć jej dane i nie jest równoważna zwykłemu ponownemu uruchomieniu. Przed resetowaniem aplikacji, zmianą ustawień lub reinstalacją składników należy ustalić, gdzie przechowywane są projekty, konfiguracje, klucze i inne pliki znajdujące się w środowisku WSL. W wielu przypadkach wystarczające okazuje się odtworzenie profilu Terminala, naprawa aplikacji, ponowne uruchomienie wymaganych składników albo aktualizacja WSL.

Kiedy najlepiej zlecić diagnozę specjalistom - wsl nie działa z wt.exe

Zgłoszenie do serwisu jest uzasadnione, gdy problem powtarza się po ponownym uruchomieniu systemu, dotyczy kilku dystrybucji albo uniemożliwia dostęp do plików i narzędzi potrzebnych do pracy. Szczególnej ostrożności wymaga sytuacja, w której polecenia naprawcze sugerują reset, wyrejestrowanie dystrybucji lub ponowną instalację, a w środowisku WSL znajdują się niezarchiwizowane dane. Wtedy najpierw powinno się ustalić zakres możliwej utraty informacji i przygotować kopię, o ile system nadal pozwala na dostęp do plików.

Pomoc techniczna może obejmować rozdzielenie problemu na warstwę WSL, Windows Terminal, profil użytkownika i ustawienia systemowe, a następnie sprawdzenie dzienników zdarzeń oraz komunikatów zwracanych przez polecenia diagnostyczne. Istotne jest również ustalenie, czy błąd pojawił się po aktualizacji, zmianie konta, instalacji nowej dystrybucji lub modyfikacji konfiguracji Terminala. Dzięki temu można uniknąć przypadkowych działań, które usuwają objawy razem z danymi.

W Warszawie takie przypadki przyjmuje Warszawskie Pogotowie Komputerowe 24/7, gdzie możliwe jest przeanalizowanie zależności między konfiguracją systemu Windows, instalacją WSL oraz profilem uruchamianym przez wt.exe. Przed przekazaniem urządzenia warto zanotować pełną treść komunikatu, nazwę używanej dystrybucji, wynik podstawowych poleceń oraz moment, od którego występuje usterka. Nie powinno się podawać haseł ani usuwać danych tylko po to, aby przygotować komputer do diagnostyki.

Do czasu wyjaśnienia przyczyny można korzystać z bezpośredniego uruchamiania wsl.exe w PowerShellu, o ile środowisko działa w tym trybie i nie powoduje to dodatkowych błędów. Jeżeli nie działa również bezpośrednie polecenie WSL, a Windows Terminal jest jedynie miejscem, w którym usterka staje się widoczna, naprawa powinna objąć składniki systemowe, rejestrację dystrybucji i konfigurację użytkownika, a nie tylko sam skrót lub ikonę Terminala.