Rozdział 2 · Ustaw Python!Typowe problemy i diagnoza
Osiem Nazwanych Laboratoriów – Katalog typowych problemów w tym rozdziale i sposoby ich rozwiązania.
Zebraliśmy osiem najczęstszych problemów tego rozdziału w jednym miejscu — jako odniesienie do których możesz wrócić, gdy coś pójdzie nie tak. Każdy z nich został już uporządkowany w trakcie rozdziału; Oto zwięzła wersja do szybkiej diagnozy.
Objaw: Komenda python nie znaleziono w terminalu.
Przyczyna i rozwiązanie: Python nie jest zainstalowane ani dodane do PATH (Windows: pola „Add python.exe to PATH” python3 zamiast python (sekcja 2.4).
Objaw: pip install odmawia pracy dla Linux/macOS.
Przyczyna i rozwiązanie: To jest ochrona PEP 668 (rozdział 2.5): utwórz i aktywuj środowisko wirtualne (rozdział 2.11) i instaluj tam pakiety — nie do systemowego Python.
Objaw: Pakiet jest zainstalowany, ale import upada.
Przyczyna i rozwiązanie: Pakiet jest zainstalowany nie w tym środowisku, z którego uruchamiany jest kod. Sprawdź sys.executable (Rozdział 2.6) z aktywnym środowiskiem terminalnym oraz z interpreterem wybranym w VS Code (Rozdział 2.8) – zobacz laboratorium Sekcji 2.12.
Objaw: Zachowanie przy rozpoczęciu z VS Code różni się od startu z terminala.
Przyczyna i rozwiązanie: Sprawdź „Select Interpreter” .vscode/settings.json projektu.
Objaw: Komunikat terminala się nie wyświetla (.venv)paczki są „zniknęły”
Przyczyna i rozwiązanie: Środowisko nie jest aktywowane w tym oknie terminala – aktywacja nie jest zapisywana między zakładkami (sekcja 2.11). Uruchom ponownie polecenie aktywacji dla swojego systemu operacyjnego.
Objaw: python --version pokazuje inną wersję niż ta, którą właśnie zainstalowałeś.
Przyczyna i rozwiązanie: Na komputerze jest kilka interpreterów, a PATH znajduje inny interpreter niż oczekiwano (Rozdział 2.2). Sprawdź kolejność w which / where.exe (Rozdział 2.6).
Objaw: B .ipynb import nie znajduje pakietu, który jest dokładnie zainstalowany.
Przyczyna i rozwiązanie: Notes ma inne jądro (kernel) nie jest środowiskiem, w którym umieszczasz pakiet (sekcja 2.15). Zmień jądro w prawym górnym rogu notesu.
Objaw: Zespół pip wciąż nie znajduje się w aktywowanym środowisku.
Przyczyna i rozwiązanie: Rzadka sytuacja uszkodzonego środowiska — utwórz je na nowo: usuń folder .venv i wykonaj python -m venv .venv nowe (Rozdział 2.11).
sys.executable (Rozdział 2.6), komunikat terminala (.venv) i wybór tłumacza w edytorze (Rozdział 2.8) — zanim podejrzesz coś bardziej skomplikowanego.