`wsl --list` niepokazujące żadnych dystrybucji mimo wcześniejszej instalacji oznacza uszkodzony rejestr dystrybucji WSL — sprawdza się to dodatkowo poleceniem `wsl --list --all`, które pokazuje też dystrybucje w trakcie instalacji.
Co oznacza komunikat, że wsl --list nie pokazuje żadnych dystrybucji
Brak pozycji po wykonaniu polecenia wsl --list oznacza, że system Windows nie prezentuje w tym miejscu żadnej zarejestrowanej dystrybucji Linuksa. Nie musi to jednak od razu oznaczać całkowitego usunięcia środowiska WSL ani utraty plików użytkownika. Przyczyną może być niepełna instalacja, zmiana domyślnej wersji WSL, problem z usługami systemowymi albo niespójność informacji zapisanych w rejestrze dystrybucji.
Warto rozróżnić sytuację, w której dystrybucja rzeczywiście nie została jeszcze zainstalowana, od przypadku, gdy została pobrana, lecz nie zakończył się proces jej inicjalizacji. Pomocne jest wtedy polecenie wsl --list --all, ponieważ uwzględnia również środowiska znajdujące się w stanie instalowania, zatrzymania lub przejściowej rejestracji. Dodatkowe informacje można uzyskać przez wsl --status oraz wsl --version, o ile używana wersja WSL obsługuje te przełączniki.
Problem dotyczy warstwy zarządzającej dystrybucjami, a nie samego polecenia powłoki Linuksa. Jeżeli lista pozostaje pusta, nie należy od razu tworzyć kolejnej dystrybucji, ponieważ może to utrudnić ustalenie, czy wcześniejsze środowisko nadal znajduje się w systemie, lecz nie jest prawidłowo wykazywane.
Jak działa lista dystrybucji WSL i gdzie może powstać rozbieżność
Windows Subsystem for Linux korzysta z kilku powiązanych elementów: opcjonalnych składników systemu Windows, aplikacji lub pakietu WSL, usług odpowiedzialnych za uruchamianie środowiska oraz danych opisujących poszczególne dystrybucje. Lista wyświetlana przez wsl --list jest wynikiem odczytu informacji o dystrybucjach zarejestrowanych dla bieżącego systemu. Jej zawartość może więc różnić się od tego, co wynika z obecności plików dystrybucji na dysku.
W praktyce znaczenie ma także wersja używanego interfejsu WSL. W starszych konfiguracjach część funkcji była dostarczana jako składniki systemowe, natomiast w nowszych środowiskach aktualizowany jest również pakiet WSL. Z tego powodu polecenia diagnostyczne mogą zwracać inne informacje na różnych komputerach, mimo że objaw wygląda podobnie. Należy sprawdzić, czy działanie odbywa się w odpowiednim kontekście użytkownika oraz czy terminal został uruchomiony z uprawnieniami wystarczającymi do wykonania czynności naprawczych.
Nie powinno się utożsamiać pustej listy z brakiem wszystkich danych. Dystrybucja może mieć stan nieukończonej rejestracji, znajdować się pod inną nazwą, być przypisana do innego profilu użytkownika albo wymagać ponownego uruchomienia komponentów WSL. Przed modyfikacją środowiska warto zabezpieczyć ważne pliki, szczególnie jeśli wcześniej korzystano z projektów przechowywanych wewnątrz systemu plików dystrybucji.
Najczęstsze przyczyny pustego wyniku
Jedną z typowych przyczyn jest przerwana instalacja. Pobranie pakietu dystrybucji nie zawsze oznacza, że jej rejestracja została zakończona. Jeżeli komputer został wyłączony, aktualizacja przerwana albo proces instalacyjny zamknięty przed pierwszym uruchomieniem, wpis może pozostać w stanie niepełnym. W takim przypadku wsl --list --all może dostarczyć więcej informacji niż podstawowa lista.
Innym źródłem problemu bywa niespójność składników systemu po aktualizacji Windows, zmianie funkcji opcjonalnych lub przywróceniu systemu z kopii. Znaczenie mogą mieć również wyłączone składniki wymagane przez WSL, nieuruchomiona obsługa maszyn wirtualnych albo uszkodzone dane aplikacji dystrybucji. Jeżeli WSL działało wcześniej, a po aktualizacji przestało wykazywać środowiska, należy porównać wynik poleceń statusowych z historią zmian systemowych.
Pusta lista może pojawić się także po ręcznym usunięciu dystrybucji, zmianie profilu użytkownika lub odtworzeniu katalogu z kopii bez odtworzenia jego rejestracji w WSL. Niekiedy problem wynika z użycia innego konta niż to, na którym przeprowadzono instalację. Warto wtedy sprawdzić nazwę użytkownika, dostęp do katalogów przechowujących dane oraz informacje widoczne w ustawieniach zainstalowanych aplikacji.
Przed zastosowaniem poleceń usuwających lub wyrejestrowujących należy zachować ostrożność. Operacje tego typu mogą skasować dane dystrybucji, a ponowne pobranie środowiska nie musi przywrócić plików, konfiguracji i pakietów z poprzedniej instalacji. Bezpieczniejsza kolejność obejmuje zebranie wyników diagnostycznych, sprawdzenie stanu WSL, potwierdzenie obecności danych oraz dopiero późniejsze odtworzenie rejestracji lub instalację środowiska.
W jakich sytuacjach warto umówić wizytę serwisową - wsl --list nie pokazuje żadnych dystrybucji
Zgłoszenie do serwisu warto rozważyć, gdy dystrybucja była wcześniej używana do pracy, a polecenia wsl --list i wsl --list --all nie pokazują oczekiwanych wpisów mimo zachowania danych na dysku. Pomoc może być potrzebna również wtedy, gdy pojawiają się komunikaty o błędach usług, brak uprawnień, nieudana rejestracja albo niezgodność pomiędzy stanem aplikacji WSL i ustawieniami systemu Windows.
Przed przekazaniem komputera dobrze jest opisać, kiedy problem wystąpił, czy wcześniej wykonywano aktualizację, zmianę konta lub przywracanie systemu oraz czy w środowisku znajdowały się ważne projekty. Takie informacje ułatwiają odróżnienie awarii konfiguracji od przypadkowego wyrejestrowania dystrybucji i pomagają dobrać postępowanie ograniczające ryzyko utraty danych.
W Warszawskim Pogotowiu Komputerowym 24/7 można zlecić sprawdzenie konfiguracji Windows, komponentów WSL oraz stanu zapisanych środowisk, z uwzględnieniem potrzeby zachowania danych użytkownika. W przypadku laptopa przed rozpoczęciem naprawy przysługuje darmowa diagnoza LAPTOPA, co pozwala najpierw ustalić źródło pustej listy, a dopiero potem zdecydować o dalszych czynnościach.
