Гайды

Как создать виртуальное окружение Python (venv) — за пять команд, без каши из библиотек

Иллюстрация: два проекта, у каждого своя закрытая коробка с библиотеками, между ними чистая система

Ставишь библиотеку для одного проекта — и внезапно ломается другой, который вчера работал. Классика Python: пакеты валятся в одну общую кучу, версии дерутся между собой, и в проигрыше кто-то один. Виртуальное окружение (venv) — это отдельная коробка с библиотеками под один проект. Сделал один раз — и проекты перестают мешать друг другу. Показываю по шагам.

Что такое venv и зачем он (30 секунд теории)

Коротко: venv — это папка внутри проекта, куда складываются библиотеки только этого проекта. У проекта A свой набор и свои версии, у проекта B — свои, а система остаётся чистой. Без venv pip install кидает всё в общую кучу, и рано или поздно проект A требует одну версию пакета, проект B — другую, и кто-то ломается.

Шаг 1. Проверь, что Python есть

Открой терминал и набери:

python3 --version

Если печатается версия (например, Python 3.12.4) — всё на месте. Если «команда не найдена» — сначала поставь Python с python.org. На Windows команда часто просто python, без тройки.

Шаг 2. Создай окружение

Перейди в папку проекта и выполни:

python3 -m venv .venv

Появится папка .venv — это и есть твоя коробка. Имя .venv общепринятое: точка в начале прячет её из общего списка, и её автоматически узнают редакторы кода.

Шаг 3. Активируй его

macOS / Linux:

source .venv/bin/activate

Windows (PowerShell):

.venv\Scripts\Activate.ps1

Признак, что сработало, — в начале строки терминала появилось (.venv). Теперь python и pip указывают внутрь коробки, а не в систему.

Шаг 4. Ставь библиотеки как обычно

pip install requests

Теперь requests лёг в .venv, а не в систему. Это ровно тот же pip — просто он работает внутри изолированной коробки. Особенно это спасает с тяжёлыми ИИ-библиотеками: если запускаешь модель локально, держи её зависимости в отдельном venv, чтобы не засорять всю систему.

Шаг 5. Зафиксируй список и выходи

Чтобы другой человек (или ты завтра на другой машине) собрал те же версии:

pip freeze > requirements.txt

Файл requirements.txt — это список «что и какой версии». Позже поставить всё разом можно одной командой: pip install -r requirements.txt. Выйти из окружения:

deactivate

Что получится

Папка .venv с библиотеками только этого проекта и файл requirements.txt со списком версий. Проекты больше не дерутся за пакеты, а любой человек сможет воспроизвести твоё окружение одной командой.

Нужно ли добавлять .venv в .gitignore?

Да, обязательно. Саму папку .venv в Git не кладут: она тяжёлая и своя на каждой машине. В репозиторий идёт только requirements.txt — по нему любой пересоздаст окружение у себя. Добавь строку .venv/ в .gitignore и не думай об этом.

venv, virtualenv, conda — в чём разница?

venv встроен в Python, и его хватает в 90% случаев — с него и начинай. virtualenv — более старый внешний инструмент с теми же идеями. conda — отдельный менеджер (популярен в data science): он ставит не только Python-пакеты, но и системные зависимости. Новичку правило простое: бери встроенный venv, а к остальному переходи, только когда упрёшься в конкретную потребность.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →