wsl --set-version nie działa

`wsl --set-version` niedziałające oznacza niepowodzenie konwersji dystrybucji między WSL1 a WSL2 — częsta przyczyna to brak włączonej funkcji „Platforma maszyny wirtualnej” wymaganej przez WSL2.

Czym oznacza komunikat „wsl --set-version nie działa”

Problem z poleceniem wsl --set-version pojawia się wtedy, gdy system Windows nie potrafi zmienić sposobu działania wybranej dystrybucji Linuxa pomiędzy WSL1 i WSL2. Samo polecenie służy do wskazania nazwy dystrybucji oraz docelowej wersji środowiska, na przykład wsl --set-version Ubuntu 2. Jeżeli operacja kończy się błędem, konwersja nie zostaje wykonana albo proces zatrzymuje się bez wyraźnego komunikatu, przyczyny należy szukać w konfiguracji funkcji systemowych, stanie konkretnej dystrybucji lub użytej składni.

WSL1 i WSL2 nie są jedynie dwoma oznaczeniami tej samej konfiguracji. WSL1 korzysta z warstwy tłumaczącej wywołania systemu Linux, natomiast WSL2 uruchamia właściwe środowisko Linux z wykorzystaniem mechanizmów wirtualizacyjnych Windows. Z tego powodu przełączenie dystrybucji wymaga spełnienia dodatkowych warunków, a niekiedy także aktualizacji składników systemu. Błąd polecenia nie musi oznaczać uszkodzenia plików dystrybucji, ale nie powinno się rozpoczynać kolejnych prób bez ustalenia, na którym etapie operacja się nie powiodła.

Kontekst techniczny i porównanie WSL1 z WSL2

Przed użyciem polecenia warto sprawdzić dostępne dystrybucje oraz ich aktualny tryb komendą wsl --list --verbose. Wynik pokazuje nazwę dystrybucji, jej stan i numer wersji WSL. Dzięki temu można potwierdzić, czy wpisywana nazwa jest prawidłowa, czy środowisko jest już w wersji 2 oraz czy problem dotyczy jednej dystrybucji, czy całej funkcji WSL.

WSL2 zwykle lepiej obsługuje narzędzia wymagające zachowania bliższego pełnemu środowisku Linux, ale wymaga poprawnie skonfigurowanych komponentów systemu Windows związanych z maszyną wirtualną. WSL1 może działać w konfiguracji, w której te elementy nie są aktywne, dlatego próba przejścia do WSL2 może zakończyć się błędem dotyczącym brakującej funkcji. Należy również uwzględnić wersję Windows, aktualność pakietu WSL oraz stan samej dystrybucji.

Istotna jest poprawna kolejność działań. Najpierw powinno się zamknąć uruchomione instancje poleceniem wsl --shutdown, następnie sprawdzić status WSL i dostępność wymaganych funkcji, a dopiero później ponowić konwersję. W przypadku błędów uprawnień polecenia administracyjne należy uruchamiać w terminalu otwartym z odpowiednimi uprawnieniami. Nie powinno się usuwać dystrybucji ani jej ponownie instalować bez wcześniejszego zabezpieczenia danych przechowywanych w jej systemie plików.

Typowe problemy i błędy przy zmianie wersji

Jedną z częstszych przyczyn jest nieaktywna funkcja „Platforma maszyny wirtualnej”. WSL2 potrzebuje także poprawnie działającego składnika „Podsystem Windows dla systemu Linux”. Po zmianie tych ustawień może być wymagane ponowne uruchomienie komputera. Samo zaznaczenie funkcji w oknie składników systemu nie zawsze wystarcza, jeżeli aktualizacja Windows jest niepełna albo system nie został jeszcze zrestartowany.

Problemy mogą wynikać również z nieaktualnego jądra WSL, starszej wersji aplikacji systemowej WSL, wyłączonej w oprogramowaniu układowym obsługi wirtualizacji lub ograniczeń narzuconych przez konfigurację systemu. W takiej sytuacji warto sprawdzić wynik polecenia wsl --status, wersję poleceniem wsl --version oraz stan funkcji opcjonalnych Windows. Treść komunikatu, kod błędu i moment jego wystąpienia często pozwalają rozróżnić problem z funkcją systemową od problemu z konkretną dystrybucją.

Osobną grupę stanowią błędy składni. Nazwa dystrybucji musi odpowiadać nazwie wyświetlanej przez wsl --list, a numer wersji należy podać jako 1 albo 2. Wpisanie nazwy zawierającej spacje, użycie nieprawidłowego numeru lub pomylenie opcji z innym poleceniem może sprawić wrażenie awarii WSL, mimo że problem znajduje się wyłącznie w sposobie wydania komendy.

Konwersja może też nie dojść do skutku z powodu braku wolnego miejsca, błędów w pliku wirtualnego dysku dystrybucji albo nieprawidłowego zamknięcia wcześniejszej sesji. Przy ważnych danych zalecane jest wykonanie kopii eksportowej dystrybucji, na przykład za pomocą wsl --export, przed podejmowaniem działań naprawczych. Należy unikać przerywania konwersji przez zamknięcie terminala lub wymuszenie restartu, ponieważ może to pogorszyć stan środowiska.

Kiedy warto zgłosić sprzęt do serwisu - wsl --set-version nie działa

Wizyta w serwisie jest uzasadniona, gdy polecenie nadal kończy się błędem po sprawdzeniu składników Windows, aktualizacji WSL, ponownym uruchomieniu komputera i potwierdzeniu prawidłowej nazwy dystrybucji. Szczególnej ostrożności wymagają sytuacje, w których w dystrybucji znajdują się projekty, klucze, konfiguracje narzędzi lub inne dane, a komunikat wskazuje na uszkodzenie dysku wirtualnego albo niemożność odczytu systemu plików. Wtedy bezpieczniejsze jest najpierw ustalenie możliwości wykonania kopii, zamiast wielokrotnie ponawiać konwersję.

W Warszawie pomoc przy diagnostyce problemów z Windows, terminalem i środowiskiem WSL można uzyskać w serwisie laptopów i komputerów PC działającym jako Warszawskie Pogotowie Komputerowe 24/7. Przy zgłoszeniu warto przekazać dokładną treść komunikatu, wynik poleceń wsl --list --verbose i wsl --status, wersję Windows oraz informację, której dystrybucji dotyczy problem. Takie dane ułatwiają odtworzenie sytuacji i ograniczają ryzyko niepotrzebnych zmian w konfiguracji. Naprawy trwają z reguły do 3 dni roboczych.