`wsl --set-default` kończące się błędem oznacza, że wskazana nazwa dystrybucji nie istnieje lub jest błędnie zapisana — nazwy trzeba podawać dokładnie tak, jak zwraca `wsl --list`.
Czym oznacza błąd polecenia wsl --set-default
Komunikat o niepowodzeniu przy wykonywaniu wsl --set-default wskazuje, że środowisko WSL nie potrafi ustawić podanej dystrybucji jako domyślnej. Polecenie służy do wyboru systemu Linux, który ma być uruchamiany po wpisaniu samego wsl, bez dodatkowego parametru określającego konkretną dystrybucję. Nie instaluje ono nowego systemu, nie naprawia uszkodzonej dystrybucji i nie zmienia ustawień systemu Windows poza wyborem domyślnego środowiska WSL.
Najczęściej problem wynika z użycia nazwy skróconej, nazwy wyświetlanej nieprecyzyjnie albo oznaczenia różniącego się od identyfikatora zapisanego przez WSL. Wielkość liter zwykle nie jest najważniejszą przyczyną, ale dodatkowe spacje, pominięte znaki, zmieniona numeracja wydania lub niedozwolona składnia mogą spowodować odrzucenie polecenia. Warto traktować nazwę dystrybucji jako dokładny identyfikator, a nie jako dowolny opis systemu Linux.
Kontekst techniczny i sposób sprawdzenia właściwej nazwy
Przed zmianą ustawienia należy wyświetlić dystrybucje zarejestrowane w WSL. W terminalu można użyć polecenia wsl --list, a w bardziej szczegółowym wariancie wsl --list --verbose. Druga forma pokazuje między innymi stan dystrybucji oraz wykorzystywaną wersję WSL, co pomaga odróżnić system rzeczywiście zainstalowany od nazwy zapamiętanej z wcześniejszej konfiguracji.
Jeżeli na liście znajduje się na przykład wpis Ubuntu-24.04, należy wykorzystać właśnie tę postać:
wsl --set-default Ubuntu-24.04
Nie należy zastępować jej ogólnym określeniem Ubuntu, jeśli taki wpis nie występuje w wynikach polecenia. Gdy nazwa zawiera spacje albo nietypowe znaki, można ująć ją w cudzysłów:
wsl --set-default "Nazwa dystrybucji"
Po prawidłowym ustawieniu warto ponownie uruchomić wsl --list --verbose i sprawdzić, przy której dystrybucji znajduje się oznaczenie domyślnego systemu. Można też uruchomić samo wsl, aby potwierdzić, że otwiera się oczekiwane środowisko. Jeżeli polecenie nadal kończy się błędem, przyczyną może być brak zarejestrowanej dystrybucji, uszkodzone wpisy konfiguracyjne, niepełna instalacja WSL albo uruchomienie terminala z innymi uprawnieniami niż te używane podczas instalacji.
Typowe problemy prowadzące do niepowodzenia
Jednym z częstych błędów jest wpisanie nazwy dystrybucji na podstawie ikony w menu Start, nazwy pobranego pakietu lub nazwy folderu przechowywanego na dysku. Te oznaczenia nie muszą odpowiadać nazwie rozpoznawanej przez WSL. Rozbieżność może pojawić się również po imporcie dystrybucji, zmianie wersji wydania albo usunięciu systemu bez uporządkowania pozostałych skrótów i wpisów.
Inna sytuacja występuje wtedy, gdy lista dystrybucji jest pusta. W takim przypadku ustawienie domyślnego systemu nie jest możliwe, ponieważ WSL nie ma czego wybrać. Najpierw trzeba zweryfikować stan składników WSL oraz obecność zainstalowanej dystrybucji. Samo ponawianie komendy z inną nazwą nie rozwiąże problemu, jeśli żadna dystrybucja nie została prawidłowo zarejestrowana.
Znaczenie ma także rodzaj użytego polecenia. wsl --set-default wskazuje dystrybucję uruchamianą domyślnie, natomiast wsl --set-version dotyczy wersji mechanizmu WSL przypisanej do konkretnej dystrybucji. Pomylenie tych opcji może prowadzić do błędnej diagnozy. Warto również odróżnić ustawienie domyślnej dystrybucji od wyboru domyślnego użytkownika Linux, konfiguracji katalogu startowego lub naprawy samego systemu plików.
Jeśli nazwa jest poprawna, a błąd nadal występuje, pomocne bywa sprawdzenie aktualizacji systemu Windows, stanu usługi odpowiedzialnej za uruchamianie środowisk WSL oraz komunikatów zwracanych przez wsl --status. Należy zachować ostrożność przy poleceniach usuwających dystrybucję lub wyrejestrowujących jej dane, ponieważ takie działania mogą skasować pliki zapisane w danym środowisku.
Kiedy trzeba umówić wizytę serwisową - wsl --set-default kończy się błędem
Do serwisu warto zgłosić się wtedy, gdy błąd nie ogranicza się do jednej pomylonej nazwy, a lista dystrybucji jest pusta, środowisko nie uruchamia się, polecenia WSL zwracają niespójne komunikaty albo problem pojawił się po aktualizacji systemu. Szczególnie wskazane jest wcześniejsze zabezpieczenie ważnych plików z katalogu domowego Linux i przygotowanie pełnego komunikatu błędu, wersji Windows oraz wyniku poleceń wsl --list --verbose i wsl --status.
W Warszawie pomoc przy takich przypadkach świadczy Warszawskie Pogotowie Komputerowe 24/7, gdzie przed dalszymi czynnościami można ustalić, czy źródłem problemu jest wyłącznie błędny identyfikator dystrybucji, czy też nieprawidłowa konfiguracja komponentów systemu. Przy zgłoszeniu dotyczącym laptopa wykonywana jest darmowa diagnoza LAPTOPA, co pozwala najpierw rozpoznać zakres usterki i dopiero potem dobrać bezpieczny sposób postępowania z instalacją WSL oraz przechowywanymi w niej danymi.
