Как создать виртуальное окружение Python — базовый вопрос для любого проекта, где нужны свои библиотеки без конфликтов с системным Python. Такой подход позволяет держать зависимости отдельно для каждой папки, спокойно тестировать разные версии пакетов и не ломать другие проекты.
Что дает виртуальное окружение Python
Виртуальное окружение Python создает изолированную копию интерпретатора и набор пакетов только для одного проекта. В нем можно ставить нужные библиотеки, не затрагивая глобальное окружение системы.
Такой подход особенно полезен, когда:
- в разных проектах нужны разные версии одной и той же библиотеки;
- нужна воспроизводимая конфигурация для работы в команде;
- потом нужно быстро удалить зависимости вместе с проектом;
- есть риск повредить системные пакеты при глобальной установке.
Как создать виртуальное окружение Python через venv
Как создать виртуальное окружение Python проще всего через встроенный модуль venv, который уже есть в современных версиях Python. Для большинства пользователей это самый удобный вариант без дополнительных инструментов.
Перейдите в папку проекта и выполните команду:
python -m venv venv
После этого в папке проекта появится новый каталог venv с отдельным окружением. Название можно изменить, но короткое venv обычно удобнее в повседневной работе.
Активация окружения
Активация виртуального окружения Python нужна, чтобы команды python и pip работали именно внутри этого проекта.
- Windows: venv\Scripts\activate
- macOS / Linux: source venv/bin/activate
После активации в терминале обычно появляется название окружения в скобках. Это удобный признак того, что вы уже работаете не в системном Python.
Проверка, что все сработало
Проверка виртуального окружения Python занимает несколько секунд и помогает сразу увидеть ошибки.
- Выполните python —version и убедитесь, что запускается нужная версия.
- Выполните pip list и посмотрите, что список пакетов пустой или минимальный.
- Установите тестовый пакет, например pip install requests, а затем повторите pip list.
Если пакет установился без ошибок и появился в списке, окружение работает правильно. Если команда не находится, проверьте путь к Python и повторите активацию.
Как устанавливать и удалять пакеты внутри окружения
Управление пакетами в виртуальном окружении Python выполняется через pip, но только после активации окружения. Именно тогда установка не выходит за пределы проекта.
Типовые команды выглядят так:
- pip install package-name — установить пакет;
- pip uninstall package-name — удалить пакет;
- pip freeze > requirements.txt — сохранить список зависимостей;
- pip install -r requirements.txt — восстановить зависимости на другом компьютере.
Если нужно проверить, что все записалось правильно, откройте requirements.txt или запустите pip freeze еще раз и сравните список.
Как выйти из окружения и удалить его
Выход из виртуального окружения Python выполняется одной командой: deactivate. После этого терминал возвращается к системному Python или к другому активному окружению.
Удаление окружения тоже простое: достаточно стереть папку venv. Это безопасный шаг для проекта, но перед удалением стоит убедиться, что нужные зависимости сохранены в requirements.txt.
Если проект перестал запускаться после удаления, создайте окружение заново и установите пакеты из файла зависимостей.
Самые частые ошибки при создании окружения
Самые частые проблемы с виртуальным окружением Python связаны не с самим venv, а с неправильным интерпретатором или пропущенной активацией.
- Команда python не найдена. Проверьте, установлен ли Python и добавлен ли он в PATH.
- venv не создается. Запустите команду из правильной папки проекта и убедитесь, что у вас есть права на запись.
- Пакеты ставятся не туда. Перед pip install еще раз активируйте окружение.
- Старая версия Python. Для venv лучше использовать современную версию Python 3.
Если ошибка повторяется, сначала проверьте python —version и путь к исполняемому файлу, а уже потом переустанавливайте пакеты.
