Rozdział 2 · Ustaw Python!

Stwórz . venv

Od polecenia, przez to, co faktycznie pojawia się na dysku, oraz jak włączać i wyłączać środowisko.

Teraz, gdy rozumiemy dlaczego, stwórzmy pierwsze środowisko wirtualne. Moduł venv jest zawarta w standardowej bibliotece Python – osobno Nic nie jest potrzebne (poza Linux, gdzie czasem wymagany jest pakiet systemowy python3-venv, zobacz sekcję 2.5).

Tworzenie środowiska

Otwórz terminal w folderze projektu i uruchom:

Windows / macOS / Linux
python -m venv .venv
Co oznacza kropka przed nazwą
Nazwa .venv zaczyna się od kropki na macOS i Linux jest to standardowa konwencja dla „ukrytych” ls bez flag nie są wyświetlane, aby nie zagracać lista plików serwisowych. Folder może być także nazwany bez kropki (na przykład venv), ale .venv jest najczęstszym porozumieniem i jest również domyślnie uznawane VS Code i PyCharm.

Co pojawiło się na płycie

Zespół stworzył folder .venv ze swoją wewnętrzną strukturą:

.venv/ (macOS / Linux)
.venv/
├── bin/
│   ├── python -> /usr/local/bin/python3.14
│   ├── pip
│   └── activate
├── lib/
│   └── python3.14/site-packages/
└── pyvenv.cfg
.venv\ (Windows)
.venv\
├── Scripts\
│   ├── python.exe
│   ├── pip.exe
│   └── activate.bat
├── Lib\
│   └── site-packages\
└── pyvenv.cfg

Najważniejsze jest tutaj site-packages: właśnie tutaj trafią pakiety, które zainstalujesz dla tego projektu, i właśnie ten folder jest odizolowany od innych projektów (rozdział 2.10). Plik pyvenv.cfg przechowuje odniesienie do „rodzica”

Aktywacja środowiska

Samo stworzenie środowiska nie oznacza, że jest ono wykorzystywane – jest konieczne aktywuj w obecnym terminalu:

macOS / Linux (bash/zsh)
source .venv/bin/activate
Windows (PowerShell)
.venv\Scripts\Activate.ps1
Windows (cmd.exe)
.venv\Scripts\activate.bat

Po aktywacji polecenie w wierszu poleceń się zmieni — przed nim pojawi się (.venv). To jest sygnał wizualny: teraz polecenia python oraz pip w tym terminalu wskazują dokładnie na interpreter i pakiety tego środowiska, a nie na systemowy lub globalnie zainstalowany Python.

Terminal po aktywacji
(.venv) anna@laptop project %
Aktywacja – dla każdej nowej karty/okna terminala
Aktywacja jest ważna tylko w oknie terminala, w którym ją wykonałeś. Jeśli otworzysz nową zakładkę terminala, ponownie aktywuj środowisko. VS Code zwykle robi to automatycznie dla wbudowanego terminala (sekcja 2.8), jeśli ten interpreter jest wybrany dla projektu.

Dezaktywacja

Aby powrócić do normalnego, „globalnego”

Każdy system operacyjny
deactivate
Podstawowa praktyka
Stwórz i aktywuj swoje pierwsze środowisko

Utwórz folder o dowolnej nazwie, otwórz w nim terminal, uruchom python -m venv .venv, aktywuj go poleceniem dla twojego systemu operacyjnego i upewnij się, że zachęta w wierszu poleceń zmieniła się na (.venv).