Глава 2 · Давайте установим Python!

Создаём .venv

От команды — к тому, что реально появляется на диске, и как включить и выключить окружение.

Теперь, когда понятно зачем — создадим первое виртуальное окружение. Модуль venv входит в стандартную библиотеку Python — отдельно ставить ничего не нужно (кроме Linux, где иногда требуется системный пакет python3-venv, см. раздел 2.5).

Создание окружения

Откройте терминал в папке вашего проекта и выполните:

Windows / macOS / Linux

python -m venv .venv

Что означает точка перед именем

Имя .venv начинается с точки — на macOS и Linux это стандартное соглашение для «скрытых» файлов и папок: обычный файловый менеджер и команда ls без флагов их не показывают, чтобы не загромождать список служебными файлами. Папку можно назвать и без точки (например, просто venv), но .venv — самое распространённое соглашение, и его же по умолчанию узнают VS Code и PyCharm.

Что появилось на диске

Команда создала папку .venv со своей внутренней структурой:

.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

Главное здесь — site-packages: именно сюда попадут пакеты, которые вы установите для этого проекта, и именно эта папка изолирована от других проектов (раздел 2.10). Файл pyvenv.cfg хранит ссылку на «родительский» интерпретатор, из которого было создано окружение.

Активация окружения

Само по себе создание окружения ещё не значит, что оно используется — его нужно активировать в текущем терминале:

macOS / Linux (bash/zsh)

source .venv/bin/activate

Windows (PowerShell)

.venv\Scripts\Activate.ps1

Windows (cmd.exe)

.venv\Scripts\activate.bat

После активации приглашение командной строки изменится — перед ним появится (.venv). Это визуальный сигнал: теперь команды python и pip в этом терминале указывают именно на интерпретатор и пакеты этого окружения, а не на системный или глобально установленный Python.

Терминал после активации

(.venv) anna@laptop project %

Активация — на каждую новую вкладку/окно терминала

Активация действует только в том окне терминала, где вы её выполнили. Открыли новую вкладку терминала — активируйте окружение заново. VS Code, как правило, делает это автоматически для встроенного терминала (раздел 2.8), если для проекта выбран этот интерпретатор.

Деактивация

Чтобы вернуться к обычному, «глобальному» состоянию терминала:

Любая ОС

deactivate

★ Базовая практика

Создайте и активируйте своё первое окружение

Создайте папку с любым именем, откройте в ней терминал, выполните python -m venv .venv, активируйте его командой для вашей ОС и убедитесь, что приглашение командной строки изменилось на (.venv).

← Назад

Зачем нужны venv

Устанавливаем первый пакет