WSL niedziałający w Terminalu wskazuje na uszkodzoną integrację profilu WSL w konfiguracji Windows Terminal.
Jak rozpoznać, czy problem dotyczy WSL, czy profilu Terminala
WSL, czyli Windows Subsystem for Linux, jest składnikiem systemu Windows uruchamiającym środowiska dystrybucji Linuksa za pośrednictwem narzędzia wsl.exe. Windows Terminal pełni natomiast funkcję aplikacji terminalowej i wyświetla profile, które mogą uruchamiać między innymi PowerShell, wiersz polecenia oraz konkretną dystrybucję WSL. Dlatego komunikat „WSL nie działa w Terminalu” nie zawsze oznacza awarię samego podsystemu. Przyczyną może być brak profilu dystrybucji, błędna komenda startowa, uszkodzony wpis w pliku ustawień Terminala albo problem z rejestracją dystrybucji w systemie.
Pierwszym rozróżnieniem jest sprawdzenie, czy WSL działa poza interfejsem Windows Terminal. W oknie PowerShell lub wiersza polecenia można wykonać wsl.exe --status, a następnie wsl.exe --list --verbose. Pierwsze polecenie pokazuje podstawowe informacje o konfiguracji WSL, natomiast drugie wyświetla zarejestrowane dystrybucje, ich stan oraz używaną wersję WSL. Jeżeli dystrybucja uruchamia się po wpisaniu wsl.exe, a nie uruchamia się z kafelka Windows Terminal, problem najczęściej znajduje się w konfiguracji profilu aplikacji. Jeżeli także bezpośrednie polecenie kończy się błędem, trzeba zbadać składniki WSL, usługę systemową, dystrybucję lub stan systemu Windows.
Profil dystrybucji i ustawienia Windows Terminal
Windows Terminal przechowuje konfigurację profili w ustawieniach aplikacji. Profil WSL powinien wskazywać prawidłową komendę uruchamiającą podsystem, zwykle za pomocą wsl.exe albo wariantu określającego konkretną dystrybucję, na przykład wsl.exe -d Ubuntu. Nazwa dystrybucji musi odpowiadać nazwie zwróconej przez wsl.exe --list --verbose. Różnica w pisowni, odwołanie do usuniętej dystrybucji lub wskazanie nieistniejącego pliku wykonywalnego może powodować zamknięcie karty natychmiast po jej otwarciu.
W ustawieniach Terminala istotne są również pola guid, name, commandline oraz opcjonalnie startingDirectory. Każdy profil powinien mieć unikatowy identyfikator GUID, a wartość commandline musi być zapisana jako poprawny ciąg znaków. Błąd składni JSON, nieprawidłowe cudzysłowy albo ręcznie dopisany wpis w niewłaściwej części konfiguracji może uniemożliwić wczytanie ustawień lub usunąć profil z interfejsu. W praktyce warto otworzyć ustawienia Windows Terminal i sprawdzić, czy profil dystrybucji nadal istnieje, czy jako domyślny profil nie ustawiono usuniętego wpisu oraz czy komenda profilu działa po uruchomieniu jej w PowerShell.
Jeżeli z listy zniknął profil dystrybucji, nie należy od razu usuwać danych Linuksa. Można najpierw zamknąć wszystkie karty Terminala, uruchomić ponownie aplikację i sprawdzić dostępne profile. Następnie należy porównać konfigurację Terminala z aktualną listą dystrybucji WSL. Polecenie wsl.exe --set-default <nazwa_dystrybucji> ustawia domyślną dystrybucję używaną przez wsl.exe, ale nie naprawia błędnego profilu Windows Terminal. Te dwa ustawienia są powiązane funkcjonalnie, lecz przechowywane w różnych warstwach systemu.
Test uruchamiania, stan dystrybucji i typowe komunikaty
Diagnostykę należy prowadzić od poleceń najmniej ingerujących w dane. wsl.exe --list --verbose pozwala sprawdzić, czy dystrybucja ma status Running albo Stopped i czy korzysta z WSL 1 lub WSL 2. Polecenie wsl.exe --shutdown zatrzymuje wszystkie uruchomione instancje WSL i może pomóc po zawieszeniu procesu, błędzie zamykania terminala albo nieprawidłowym stanie środowiska. Po jego wykonaniu można ponowić próbę startu dystrybucji z PowerShell, a dopiero potem z Windows Terminal. Samo zatrzymanie instancji nie usuwa systemu plików dystrybucji.
W przypadku błędu informującego o braku zainstalowanej dystrybucji należy sprawdzić listę za pomocą wsl.exe --list --online oraz aktualnie zainstalowane środowiska. Nie należy używać wsl.exe --unregister jako rutynowej metody naprawczej. To polecenie usuwa rejestrację wskazanej dystrybucji wraz z jej danymi, więc może doprowadzić do utraty plików przechowywanych w jej systemie plików. Przed takim działaniem trzeba potwierdzić, że problem dotyczy uszkodzonej dystrybucji, wykonać kopię potrzebnych danych i rozważyć eksport poleceniem wsl.exe --export.
Gdy WSL nie uruchamia się również poza Terminalem, należy zweryfikować, czy w funkcjach systemu są włączone wymagane składniki, w tym „Podsystem Windows dla systemu Linux” oraz, dla WSL 2, „Platforma maszyny wirtualnej”. Można to sprawdzić w oknie „Włączanie lub wyłączanie funkcji systemu Windows” albo za pomocą narzędzi administracyjnych systemu. Po zmianie tych składników może być wymagane ponowne uruchomienie komputera. Jeżeli problem pojawił się po aktualizacji, warto sprawdzić aktualizacje systemu Windows, wersję aplikacji Windows Terminal oraz wynik wsl.exe --update. Komendy administracyjne powinny być wykonywane tylko wtedy, gdy odpowiadają rozpoznanemu objawowi.
Przywrócenie działania bez utraty środowiska
Bezpieczna kolejność naprawy polega na ustaleniu zakresu awarii, zapisaniu dokładnego komunikatu i sprawdzeniu uruchamiania dystrybucji przez wsl.exe. Następnie można przywrócić prawidłowy profil w Windows Terminal, wskazać właściwą nazwę dystrybucji i ustawić poprawną ścieżkę katalogu startowego. Jeżeli aplikacja Terminala nie zapisuje ustawień, zawiesza się albo profile znikają po ponownym uruchomieniu, problem może dotyczyć samej aplikacji lub jej plików konfiguracyjnych, a nie rejestracji WSL. W takiej sytuacji naprawa lub ponowna instalacja Windows Terminal powinna być rozważana po zabezpieczeniu ustawień i danych.
Podczas serwisowania laptopa lub komputera PC warto oddzielić konfigurację Windows Terminal od zawartości dystrybucji WSL. Usunięcie profilu Terminala nie powinno usuwać dystrybucji, natomiast wyrejestrowanie dystrybucji usuwa jej dane. Warszawskie Pogotowie Komputerowe zajmuje się profesjonalną naprawą laptopów, komputerów PC i ich podzespołów, a w ramach diagnostyki oprogramowania można sprawdzić konfigurację WSL, Windows Terminal, wpisy startowe oraz działanie poleceń systemowych.
Jeżeli po przywróceniu profilu nadal występuje błąd, potrzebne są konkretne informacje: edycja i kompilacja Windows, wersja Windows Terminal, wynik wsl.exe --status, wynik wsl.exe --list --verbose oraz pełna treść komunikatu. Takie dane pozwalają rozstrzygnąć, czy naprawy wymaga profil aplikacji, rejestracja dystrybucji, składnik systemu Windows czy aktualizacja WSL. Dzięki temu można uniknąć przypadkowego resetowania środowiska i zachować istniejące pliki użytkownika.
