🚀 Przygotowanie środowiska

Instalacja dla kursu
AstroPython: Zbuduj Grę z Asteroidami

Potrzebujesz: VS Code + Python 3.12 + Pygame. Zajmie to ~15 minut.

🖥️ Wybierz swój system
🪟 Windows
🍎 macOS
🐧 Linux
1Pobierz i zainstaluj Visual Studio Code
⬇️ Pobierz VS Code dla Windows

Uruchom instalator (.exe), kliknij Next kilka razy. Opcjonalnie zaznacz „Add to PATH" i „Open with Code".

2Pobierz Python 3.12
⬇️ Pobierz Python 3.12 (Windows)

Pobierz Windows installer (64-bit) i uruchom.

KRYTYCZNE — zaznacz „Add Python to PATH"!
Na pierwszym ekranie instalatora zaznacz „Add python.exe to PATH" — bez tego Python i pip nie będą działać w terminalu. Następnie kliknij Install Now.
Na ekranie instalatora zaznacz:

☑ Add python.exe to PATH  ← obowiązkowe!
Kliknij: Install Now
3Sprawdź Python i pip

Otwórz Command Prompt lub PowerShell:

python --version Python 3.12.x pip --version pip 24.x.x ...
Jeśli błąd „not recognized" — wróć do kroku 2 i zaznacz Add to PATH.
4Zaktualizuj pip i zainstaluj Pygame
python -m pip install --upgrade pip pip install pygame

Instalacja zajmie chwilę — zobaczysz Successfully installed pygame-...

1Pobierz i zainstaluj Visual Studio Code
⬇️ Pobierz VS Code dla macOS

Wypakuj .zip, przeciągnij do Applications.

Dodaj do PATH: VS Code → Cmd+Shift+P → Shell Command: Install 'code' in PATH
2Zainstaluj Python 3.12
⬇️ Pobierz Python 3.12 (macOS)

Pobierz macOS 64-bit universal2 installer, uruchom .pkg.

Na macOS PATH jest ustawiany automatycznie przez instalator.
3Sprawdź Python i pip
python3 --version Python 3.12.x pip3 --version pip 24.x.x ...
Na macOS używaj python3 i pip3 zamiast python i pip.
4Zaktualizuj pip i zainstaluj Pygame
python3 -m pip install --upgrade pip pip3 install pygame
1Zainstaluj VS Code
⬇️ Pobierz VS Code dla Linux

Lub przez terminal:

sudo apt update && sudo apt install code
2Zainstaluj Python 3.12 i pip

Ubuntu/Debian:

sudo add-apt-repository ppa:deadsnakes/ppa sudo apt update sudo apt install python3.12 python3.12-pip python3.12-dev
Pygame na Linuxie może wymagać dodatkowych bibliotek SDL: sudo apt install libsdl2-dev libsdl2-image-dev libsdl2-mixer-dev
3Sprawdź instalację
python3.12 --version Python 3.12.x
4Zaktualizuj pip i zainstaluj Pygame
python3.12 -m pip install --upgrade pip python3.12 -m pip install pygame
🔵 Konfiguracja VS Code
5Zainstaluj rozszerzenie Python
  1. Otwórz VS Code → naciśnij Ctrl+Shift+X
  2. Wyszukaj: Python
  3. Zainstaluj od Microsoft (pierwsze na liście)
🐍
Python
Kolorowanie składni, IntelliSense, debugowanie
ms-python.python · Microsoft
6Utwórz folder na pliki kursu

Zanim zaczniesz pisać kod — stwórz jeden folder gdzie będą mieszkać wszystkie pliki gry. Możesz go nazwać np.:

C:\Kursy\Pygame Pulpit/gry-python Dokumenty/devostro-gry
Wszystkie pliki gry (gra_01.py, gra_02.py...) trzymaj w tym samym folderze — wtedy VS Code i terminal od razu je widzą.
7Jak używać VS Code z kursem
📂 Otwórz folder kursu

File → Open Folder → wybierz folder gdzie trzymasz pliki gra_01.py, gra_02.py...

▶️ Uruchom grę

Otwórz plik gra_01.py → kliknij ▶ Run lub w terminalu: python gra_01.py

💻 Terminal w VS Code

Terminal → New Terminal — tu uruchamiasz gry i widzisz błędy

📋 Nowy plik gry

File → New File → zapisz jako gra_01.py, wpisz kod z kursu

🎮 Test Pygame — sprawdź czy działa
8Przetestuj instalację Pygame

Stwórz plik test_pygame.py, wpisz i uruchom:

📄 test_pygame.py
import pygame pygame.init() print("Pygame wersja:", pygame.version.ver) print("Pygame działa poprawnie! 🎮") # Szybki test okna ekran = pygame.display.set_mode((800, 600)) pygame.display.set_caption("Test Devostro") ekran.fill((0, 0, 30)) pygame.display.flip() pygame.time.wait(2000) # okno widoczne przez 2 sekundy pygame.quit() print("Test zakończony! Wszystko gotowe.")

Oczekiwany wynik w terminalu:

Pygame wersja: 2.x.x Pygame działa poprawnie! 🎮 Test zakończony! Wszystko gotowe.
🎉

Jeśli widzisz granatowe okno i powyższy tekst — jesteś gotowy!

Środowisko skonfigurowane. Możesz zacząć budować Asteroidy.

❓ FAQ — najczęstsze problemy
'python' is not recognized as a command +
Python nie jest w PATH. Rozwiązanie: Odinstaluj Python i zainstaluj ponownie — na pierwszym ekranie zaznacz "Add python.exe to PATH". Uruchom ponownie terminal.
ModuleNotFoundError: No module named 'pygame' +
Pygame nie jest zainstalowany. W terminalu wpisz: pip install pygame
Jeśli błąd — spróbuj: python -m pip install pygame
'pip' is not recognized +
pip nie jest w PATH — taki sam problem jak z pythonem. Użyj zamiast tego: python -m pip install pygame — to zawsze działa jeśli Python jest zainstalowany.
Gra uruchamia się ale okno od razu się zamyka +
Prawdopodobnie masz błąd w kodzie i program się crashuje. Uruchom plik z terminala (nie podwójnym kliknięciem) — zobaczysz treść błędu: python gra_01.py
Pygame jest zainstalowany ale import nie działa w VS Code +
VS Code może używać innego interpretera Pythona. Naciśnij Ctrl+Shift+P → wpisz Python: Select Interpreter → wybierz Python 3.12 z listy.
Na macOS/Linux używać python czy python3? +
Na macOS i Linux używaj python3 i pip3. Na Windows zazwyczaj działa python i pip. Możesz sprawdzić: python3 --version
Gra działa wolno lub FPS jest niski +
To normalne na starszych komputerach lub zintegrowanej grafice. Spróbuj zmniejszyć rozdzielczość w kodzie lub obniżyć FPS: zegar.tick(30) zamiast 60.
Jak zaktualizować Pygame do nowszej wersji? +
W terminalu: pip install --upgrade pygame
🚀 Zaczynam kurs Pygame → 📖 Setup dla Python Basic