Коротко о главном
Глобальная установка библиотек быстро приводит к конфликтам между проектами. Модуль venv входит в стандартную библиотеку Python и создаёт отдельный каталог с интерпретатором и пакетами. В статье разберём создание, активацию, фиксацию зависимостей и восстановление окружения. Примеры рассчитаны на Linux и стандартный python3.
Изоляция позволяет каждому проекту иметь свои версии библиотек. Системный Python остаётся чистым, а эксперименты не ломают другие приложения. Файл requirements.txt делает сборку воспроизводимой на другой машине. Это базовый навык для разработки, тестов и небольших скриптов.
Если python venv уже установлен, основной выигрыш дают не новые функции, а привычки и правильные настройки. Собрали приёмы, которые заметно ускоряют работу.
С чего начать
Не пытайтесь применить всё сразу. Сначала настройте окружение так, чтобы команды было удобно повторять, а результаты — проверять. Для python venv это важнее, чем кажется: половина ускорения даёт предсказуемый рабочий процесс.
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
Практические советы
Эти рекомендации проверены на повседневных задачах. Начните с тех, которые закрывают вашу текущую боль, а не со всего списка сразу.
Совет 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.
Совет 6. Не используйте sudo для установки пакетов внутри виртуального окружени
Не используйте sudo для установки пакетов внутри виртуального окружения.
Совет 7. Для разных версий Python указывайте конкретный интерпретатор, например
Для разных версий Python указывайте конкретный интерпретатор, например python3.12 -m venv .venv.
Типичные ошибки
Ниже — сбои, которые встречаются чаще всего. Перед исправлением сохраните текущие конфиги и запишите, какие изменения вносите: так проще откатиться.
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.
Практический сценарий
Представьте типовую задачу: нужно развернуть python venv на одной машине, проверить работу и передать доступ коллеге. Начните с чистой системы или снапшота, чтобы результат был воспроизводим. Запишите все команды в отдельный файл — это одновременно шпаргалка и черновик будущей автоматизации.
Дальше действуйте короткими шагами: установка, минимальная конфигурация, проверка, затем расширение. После каждого шага фиксируйте, что именно изменилось и как это проверить. Такой журнал экономит время, когда через месяц понадобится повторить настройку на другом сервере или объяснить её коллеге.
Порядок работ для этого сценария выглядит так:
- Проверьте Python и модуль venv
- Создайте окружение
- Активируйте окружение
- Установите зависимости и зафиксируйте версии
- Восстановите окружение из файла
Отдельно продумайте, что произойдёт при сбое. Для python venv важно заранее знать, где хранятся данные, как их скопировать и сколько времени займёт восстановление. Если ответа нет, не двигайтесь дальше: сначала закройте этот пробел, потом добавляйте новые возможности.
Что проверить перед вводом в работу
Перед тем как считать настройку завершённой, пройдитесь по короткому списку. Он не заменяет полноценный аудит, но отсекает большинство очевидных проблем.
Чек-лист
- Версия python venv зафиксирована, а обновления не применяются вслепую.
- Есть резервная копия конфигурации и данных, восстановление проверено.
- Доступ ограничен нужными пользователями и сетями, лишние порты закрыты.
- Логи и метрики собираются, понятно, куда смотреть при сбое.
- Изменения описаны в документации и могут быть повторены на другой машине.
- Есть план отката и понятный критерий, по которому вы решите его применить.
Если какой-то пункт вызывает затруднение, это сигнал вернуться к соответствующему разделу, а не откладывать проверку. Настройка, которую нельзя повторить, плохо работает не только у коллег, но и у вас самих через полгода.
Итог
Главная ценность приёмов выше — в экономии внимания. Выберите два-три, доведите до автоматизма, и python venv перестанет отнимать время на рутину.