Коротко о главном
Глобальная установка библиотек быстро приводит к конфликтам между проектами. Модуль venv входит в стандартную библиотеку Python и создаёт отдельный каталог с интерпретатором и пакетами. В статье разберём создание, активацию, фиксацию зависимостей и восстановление окружения. Примеры рассчитаны на Linux и стандартный python3.
Изоляция позволяет каждому проекту иметь свои версии библиотек. Системный Python остаётся чистым, а эксперименты не ломают другие приложения. Файл requirements.txt делает сборку воспроизводимой на другой машине. Это базовый навык для разработки, тестов и небольших скриптов.
Надёжная работа python venv в продакшене — это не только установка, но и контроль изменений, права доступа и наблюдаемость. Ниже — практический чек-лист.
Что меняется в рабочей среде
В тестовой среде достаточно, чтобы python venv запускался. В продакшене добавляются требования к доступности, безопасности и восстановлению. Чем раньше вы зафиксируете эти требования, тем меньше придётся переделывать.
Базовая установка
Установка
В Debian, Ubuntu и Linux Mint используется пакетный менеджер APT:
sudo apt install python3-venv
В Fedora и RHEL-совместимых системах пакет ставится через DNF:
sudo dnf install python3
В Arch Linux и производных пакет доступен в официальных репозиториях:
sudo pacman -S python
Настройка и проверка
1. Проверьте Python и модуль venv
Убедитесь, что python3 доступен и модуль venv импортируется. В Debian и Ubuntu модуль иногда поставляется отдельным пакетом python3-venv. Проверка помогает заранее найти проблему с ensurepip.
python3 --version
python3 -c 'import venv; print(venv.__file__)'
2. Создайте окружение
Команда -m venv создаёт каталог .venv в текущем проекте. Внутри появляются собственные python, pip и каталог site-packages. Не редактируйте эти файлы вручную.
python3 -m venv .venv
3. Активируйте окружение
После активации команда python указывает на интерпретатор из .venv. Проверьте sys.prefix и путь к python, чтобы убедиться в изоляции. Выход выполняется командой deactivate.
source .venv/bin/activate
python -c 'import sys; print(sys.prefix)'
command -v python
4. Установите зависимости и зафиксируйте версии
Внутри окружения используйте python -m pip, чтобы не перепутать pip с глобальным. Флаг —upgrade обновляет сам установщик. Команда freeze сохраняет точные версии в requirements.txt.
python -m pip install --upgrade pip
python -m pip install requests
python -m pip freeze > requirements.txt
5. Восстановите окружение из файла
На другой машине создайте новое окружение и установите зависимости из requirements.txt. Такой подход повторяет проверенную комбинацию версий. После работы деактивируйте окружение, чтобы вернуться к системному Python.
python -m pip install -r requirements.txt
deactivate
Безопасность и наблюдаемость
Ограничьте доступ к административным интерфейсам, включите логирование и проверяйте, что изменения конфигурации применяются автоматически. Ручные правки на сервере должны быть исключением, а не нормой.
Чек-лист
- Версии пакетов и конфигурация хранятся в репозитории или системе управления.
- Есть резервная копия данных и проверенный сценарий восстановления.
- Административный доступ ограничен по сети и снабжён отдельными учётными записями.
- Логи и метрики собираются, а оповещения настроены на реальные пороги.
- Изменения проходят проверку на тестовом стенде до выката.
- Есть план отката и ответственный за его выполнение.
Практические советы
Эти рекомендации проверены на повседневных задачах. Начните с тех, которые закрывают вашу текущую боль, а не со всего списка сразу.
Совет 1. Не добавляйте каталог .venv в Git: он содержит машинозависимые файлы и
Не добавляйте каталог .venv в Git: он содержит машинозависимые файлы и легко пересоздаётся.
Совет 2. Создавайте отдельное окружение для каждого проекта, даже если зависимо
Создавайте отдельное окружение для каждого проекта, даже если зависимости кажутся одинаковыми.
Совет 3. Запускайте pip как python -m pip, чтобы гарантировать установку в акти
Запускайте pip как python -m pip, чтобы гарантировать установку в активное окружение.
Совет 4. Фиксируйте зависимости в requirements.txt и обновляйте файл осознанно
Фиксируйте зависимости в requirements.txt и обновляйте файл осознанно после проверки.
Совет 5. При создании окружения используйте —upgrade-deps, если хотите сразу о
При создании окружения используйте —upgrade-deps, если хотите сразу обновить pip и setuptools.
Типичные ошибки
Ниже — сбои, которые встречаются чаще всего. Перед исправлением сохраните текущие конфиги и запишите, какие изменения вносите: так проще откатиться.
1. python3 -m venv завершается ошибкой ensurepip is not available.
Установите пакет python3-venv в Debian или Ubuntu. В Fedora и Arch проверьте целостность установки python3 и повторите создание окружения.
2. pip отказывается устанавливать пакет из-за externally-managed-environment.
Создайте и активируйте виртуальное окружение, затем устанавливайте пакеты внутри него. Не отключайте защиту системы без веской причины.
3. После source .venv/bin/activate команда python не изменилась.
Проверьте, что путь к activate существует и команда выполнена в Bash или совместимой оболочке. Посмотрите command -v python и значение sys.prefix.
4. Пакет установился глобально, а не в проект.
Окружение не активировано или вызван другой pip. Используйте python -m pip и проверяйте путь через python -m pip —version.
Установка и версии
Проверьте, что python venv установлен и какая версия доступна. В rolling-релизах она свежая, в стабильных дистрибутивах может отставать, поэтому сверяйте документацию.
which python venv 2>/dev/null
python venv --help 2>&1 | head -30
# точное имя пакета в репозитории
apt search python venv 2>/dev/null | head -5
dnf search python venv 2>/dev/null | head -5
pacman -Ss python venv 2>/dev/null | head -5
Если утилита не найдена, проверьте PATH: необычные установки часто попадают в ~/.local/bin или /usr/local/bin.
echo $PATH
ls ~/.local/bin 2>/dev/null | head
ls /usr/local/bin | head
Итог
В рабочей среде python venv должен быть предсказуемым: версии зафиксированы, изменения проходят проверку, резервные копии существуют, а сбои видны в мониторинге. Чек-лист выше — минимальная отправная точка.