Błąd przy instalacji WSL: wsl --install nie działa

„wsl --install nie działa” oznacza, że system nie spełnia wymagań WSL2 — zwykle brakuje włączonej wirtualizacji sprzętowej w BIOS-ie lub funkcji „Platforma maszyny wirtualnej” w składnikach Windows.

Czym jest błąd przy instalacji WSL

Komunikat lub brak reakcji na polecenie wsl --install oznacza, że automatyczne przygotowanie środowiska Windows Subsystem for Linux nie zostało zakończone. WSL pozwala uruchamiać wybrane dystrybucje Linuksa bez tworzenia klasycznej maszyny wirtualnej i bez instalowania drugiego systemu na osobnej partycji. Polecenie instalacyjne powinno włączyć potrzebne składniki systemu, pobrać domyślną dystrybucję oraz przygotować jej pierwszy start, jednak powodzenie zależy od konfiguracji Windows, uprawnień użytkownika, ustawień firmware’u i dostępu do wymaganych pakietów.

Sam zapis polecenia może być poprawny, a problem może wynikać z tego, że używana wersja Windows nie obsługuje danego sposobu instalacji, system nie został zaktualizowany albo wymagane elementy nie są dostępne w bieżącej sesji. Znaczenie ma również to, czy uruchamiane jest środowisko WSL1, czy WSL2. Druga wersja korzysta z mechanizmu lekkiej wirtualizacji, dlatego jej uruchomienie wymaga szerszego zestawu aktywnych funkcji systemowych.

Kontekst techniczny i porównanie sposobów instalacji - Błąd przy instalacji WSL: wsl --install nie działa

WSL1 tłumaczy wywołania systemu Linux na mechanizmy Windows, natomiast WSL2 uruchamia rzeczywiste jądro Linuksa w odizolowanym środowisku zarządzanym przez Windows. W praktyce WSL2 zapewnia lepszą zgodność z narzędziami linuksowymi, ale jest bardziej zależne od ustawień wirtualizacji. Jeżeli polecenie instalacyjne nie działa, pomocne bywa rozdzielenie procesu na etapy: sprawdzenie wersji systemu, włączenie składników WSL oraz Platformy maszyny wirtualnej, ponowne uruchomienie komputera, ustawienie preferowanej wersji i dopiero wtedy instalacja konkretnej dystrybucji.

Warto odróżnić błąd samego komponentu WSL od problemu z pobieraniem dystrybucji. Pierwszy może objawiać się odmową dostępu, brakiem funkcji opcjonalnej albo komunikatem o niezgodnym jądrze. Drugi częściej wiąże się z usługą Microsoft Store, połączeniem sieciowym, zasadami organizacyjnymi systemu lub uszkodzonym magazynem składników Windows. Niekiedy właściwa funkcja jest już włączona, lecz system nie został jeszcze ponownie uruchomiony i nie załadował zmienionego środowiska.

Przydatne jest również sprawdzenie stanu poleceniem wsl --status, listy dostępnych dystrybucji za pomocą wsl --list --online oraz zainstalowanych środowisk przez wsl --list --verbose. Wyniki tych poleceń pozwalają ustalić, czy problem dotyczy instalacji, wyboru dystrybucji, wersji WSL czy uruchomienia konkretnego systemu plików.

Typowe problemy i błędy - Błąd przy instalacji WSL: wsl --install nie działa

Jedną z częstych przyczyn jest wyłączona wirtualizacja procesora w UEFI lub BIOS-ie. Jej nazwa może zależeć od producenta płyty głównej albo laptopa, dlatego spotyka się różne oznaczenia, między innymi Intel Virtualization Technology lub SVM Mode. Włączenie tej opcji nie zastępuje aktywacji funkcji Windows, ponieważ firmware i system operacyjny muszą jednocześnie udostępniać mechanizmy wymagane przez WSL2.

Problemy mogą też powstać po aktualizacji, przerwanym restarcie, usunięciu plików systemowych lub zmianie ustawień funkcji opcjonalnych. Pojawiają się wówczas komunikaty wskazujące na brak składnika, nieprawidłową konfigurację podsystemu, niezgodność wersji jądra albo niemożność uruchomienia maszyny wirtualnej. Należy zachować ostrożność przy przypadkowym wyłączaniu usług, kasowaniu katalogów dystrybucji i modyfikowaniu rejestru, ponieważ może to doprowadzić do utraty środowiska Linux oraz zapisanych w nim danych.

Oddzielnej diagnostyki wymaga sytuacja, w której wsl --install kończy się bez widocznego efektu. W takim przypadku należy sprawdzić, czy konsola została uruchomiona z uprawnieniami administratora, czy działa usługa Windows Update, czy system ma dostęp do źródeł pakietów oraz czy nie jest stosowana polityka blokująca opcjonalne składniki. Jeżeli błąd występuje tylko dla jednej dystrybucji, przyczyną może być jej uszkodzona rejestracja, niepełne pobranie albo problem z lokalnym profilem użytkownika.

Kiedy najlepiej poprosić o ocenę stanu sprzętu - Błąd przy instalacji WSL: wsl --install nie działa

Do serwisu warto zgłosić się wtedy, gdy podstawowe sprawdzenie wersji Windows, ponowne uruchomienie komputera i weryfikacja ustawień wirtualizacji nie przynoszą rezultatu, a komunikat błędu nadal uniemożliwia instalację lub start WSL. Szczególnie uzasadniona jest pomoc, gdy komputer ma nietypową konfigurację, system był wielokrotnie aktualizowany, występują także inne awarie składników Windows albo potrzebne jest zachowanie danych z istniejącej dystrybucji.

Przed przekazaniem sprzętu dobrze zanotować pełną treść komunikatu, moment pojawienia się problemu, używaną edycję Windows oraz informację, czy błąd dotyczy instalacji, uruchamiania czy pobierania dystrybucji. Takie dane ułatwiają odtworzenie sytuacji i ograniczają ryzyko niepotrzebnych zmian w systemie. W Warszawskim Pogotowiu Komputerowym 24/7 można zlecić sprawdzenie laptopa, a diagnoza laptopa jest darmowa, co pozwala najpierw ustalić źródło problemu przed podjęciem dalszych prac.