WSL: Linux w systemie Windows

Chcesz korzystać z narzędzi Linuxa (Docker, Python, Node.js) bez wychodzenia z Windowsa? Z pomocą przychodzi WSL (Windows Subsystem for Linux). To pełne jądro Linuxa działające równolegle z Twoim głównym systemem.

Zanim zaczniesz, zajrzyj do BIOS-u swojego komputera. Musi być w nim włączona wirtualizacja (VT-x lub AMD-V). Bez tej opcji Linux się nie uruchomi.

Sprawdźmy, jak skonfigurować oba systemy do płynnej współpracy.

---

1. Sprawdzenie stanu

Przed rozpoczęciem sprawdź aktualny stan systemu w programie PowerShell:

wsl -l -v

wsl -l -v zwróci listę zainstalowanych dystrybucji:

• Pusta odpowiedź: brak zainstalowanych dystrybucji.
• Ubuntu: Linux jest już zainstalowany.
• docker-desktop / docker-desktop-data: techniczne dystrybucje Docker Desktop.

⚠️ W kolumnie VERSION powinna widnieć cyfra 2. Jeśli widzisz 1, zaktualizuj dystrybucję komendą wsl --set-version Ubuntu 2.

---

2. Instalacja

Jeśli Linux nie jest zainstalowany, uruchom PowerShell jako administrator i wpisz:

wsl --install

System przygotuje Ubuntu. Po zakończeniu uruchom ponownie komputer, aby sfinalizować konfigurację jądra.

---

3. Konfiguracja użytkownika

Przy pierwszym uruchomieniu WSL poprosi o stworzenie użytkownika. Jeśli w terminalu widzisz root@NAZWA_PC – to normalne.

Root jest potrzebny do ustawień systemu; do codziennej pracy stwórz osobnego użytkownika.

Uwaga ⚠️: Symbol tyldy ~ to ścieżka do katalogu domowego. Dla root jest to /root, dla zwykłego użytkownika – /home/twoja_nazwa_uzytkownika. Jeśli stworzysz projekty jako root, napotkasz problemy z uprawnieniami w VS Code. Komenda cd ~/projects wpisana jako root i jako zwykły użytkownik zaprowadzi Cię w inne miejsca.

Jak stworzyć użytkownika:

# Tworzymy użytkownika twoja_nazwa_uzytkownika
adduser twoja_nazwa_uzytkownika
# Nadajemy uprawnienia administratora (dla sudo)
usermod -aG sudo twoja_nazwa_uzytkownika

Aby WSL zawsze otwierał się na Twoim użytkowniku, wpisz w Windows PowerShell:

# Zastąp twoja_nazwa_uzytkownika swoją rzeczywistą nazwą
ubuntu config --default-user twoja_nazwa_uzytkownika

Terminal będzie Cię teraz witać znakiem: twoja_nazwa_uzytkownika@NAZWA_PC:~$.

---

4. Gdzie przechowywać kod

WSL ma dostęp do dysków Windows (/mnt/c/), ale nie przechowuj tam projektów.

Systemy plików Windows i Linux komunikują się powoli. Przechowywanie projektów na dysku C: lub D: znacząco spowolni pracę z kodem.

Właściwe miejsce: folder domowy w Linuxie.
Wpisz:

cd ~
mkdir projects && cd projects

Tutaj szybkość działania jest maksymalna. Aby otworzyć folder w Eksploratorze Windows, wpisz: explorer.exe .

---

5. Stack technologiczny

Python (venv)

Izoluj pakiety w Linuxie. Nie instaluj bibliotek globalnie, używaj środowisk wirtualnych:

sudo apt update && sudo apt upgrade -y
sudo apt install python3-pip python3-venv -y

# Tworzenie projektu
mkdir moj_projekt && cd moj_projekt
python3 -m venv venv
source venv/bin/activate

Node.js (NVM)

Standardowe apt install nodejs często instaluje przestarzałą wersję. Używaj NVM (Node Version Manager):

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install --lts    # Zainstaluje aktualną stabilną wersję

---

6. Integracja

VS Code

Zainstaluj VS Code w Windowsie oraz rozszerzenie Remote – WSL. Komenda code . wpisana w terminalu Ubuntu otworzy projekt w interfejsie Windowsa, ale kod będzie wykonywany wewnątrz Linuxa.

Docker

W ustawieniach Docker Desktop (Settings -> Resources -> WSL Integration) zaznacz checkbox przy Ubuntu. Teraz możesz zarządzać kontenerami bezpośrednio z terminala Linuxa.

---

7. Szybka ściąga

• whoami – Sprawdzenie, czy jesteś rootem, czy zwykłym użytkownikiem.
• pwd – Pełna ścieżka do bieżącego folderu.
• wsl --shutdown – (w PowerShell) Całkowite zatrzymanie Linuxa w celu zwolnienia pamięci RAM.
• cat plik.txt | clip.exe – Kopiowanie tekstu z Linuxa do schowka Windowsa.

---

Workflow:

1. Otwierasz terminal (użytkownik@...).
2. Wchodzisz do projektu (cd ~/projects/moja-apka).
3. Uruchamiasz VS Code komendą code ..
4. Profit.