Коротко о главном

Глобальная установка библиотек быстро приводит к конфликтам между проектами. Модуль venv входит в стандартную библиотеку Python и создаёт отдельный каталог с интерпретатором и пакетами. В статье разберём создание, активацию, фиксацию зависимостей и восстановление окружения. Примеры рассчитаны на Linux и стандартный python3.

Изоляция позволяет каждому проекту иметь свои версии библиотек. Системный Python остаётся чистым, а эксперименты не ломают другие приложения. Файл requirements.txt делает сборку воспроизводимой на другой машине. Это базовый навык для разработки, тестов и небольших скриптов.

Этот материал — быстрый старт по python venv. За 15 минут вы получите рабочую конфигурацию и поймёте, куда смотреть дальше.

Установка

В 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

Шпаргалка по командам

  • Проверьте Python и модуль venv: python3 —version
  • Создайте окружение: python3 -m venv .venv
  • Активируйте окружение: source .venv/bin/activate
  • Установите зависимости и зафиксируйте версии: python -m pip install —upgrade pip
  • Восстановите окружение из файла: python -m pip install -r requirements.txt

Практические советы

Эти рекомендации проверены на повседневных задачах. Начните с тех, которые закрывают вашу текущую боль, а не со всего списка сразу.

Совет 1. Не добавляйте каталог .venv в Git: он содержит машинозависимые файлы и

Не добавляйте каталог .venv в Git: он содержит машинозависимые файлы и легко пересоздаётся.

Совет 2. Создавайте отдельное окружение для каждого проекта, даже если зависимо

Создавайте отдельное окружение для каждого проекта, даже если зависимости кажутся одинаковыми.

Совет 3. Запускайте pip как python -m pip, чтобы гарантировать установку в акти

Запускайте pip как python -m pip, чтобы гарантировать установку в активное окружение.

Совет 4. Фиксируйте зависимости в requirements.txt и обновляйте файл осознанно

Фиксируйте зависимости в requirements.txt и обновляйте файл осознанно после проверки.

Что дальше

Быстрый старт не означает «настроить навсегда». Когда базовый сценарий заработает, вернитесь к конфигурации и проверьте, что она переживёт перезагрузку: файлы на месте, служба включена в автозагрузку, путь к данным не зависит от текущего каталога.

Дальше имеет смысл разобраться с резервной копией и журналами python venv. Это не самая заметная часть работы, но именно она превращает эксперимент в инструмент, которым можно пользоваться каждый день.

Чек-лист

  • Команды из шпаргалки выполняются без ошибок после перезагрузки.
  • Пароли и токены не хранятся в истории команд и конфигурации в открытом виде.
  • Понятно, где смотреть логи и что считать признаком проблемы.
  • Есть копия конфигурации, которую можно восстановить.

Короткие ответы на частые вопросы

Нужно ли запускать всё от root?

Нет. Права root нужны для установки пакетов и изменения системных файлов, но сама программа и её данные должны принадлежать отдельному пользователю. Постоянная работа под root превращает любую ошибку в критическую.

Что делать, если после перезагрузки ничего не работает?

Сначала проверьте, включена ли служба в автозагрузку и не изменился ли путь к конфигурации. Посмотрите журнал текущей загрузки: он почти всегда указывает на отсутствующий файл, неверные права или занятый порт.

Как обновлять без сюрпризов?

Читайте примечания к версии, делайте резервную копию конфигурации и проверяйте обновление на тестовом стенде. Не обновляйтесь в пятницу вечером перед выходными: время на откат должно быть частью плана.

Итог

Этого достаточно, чтобы начать. Дальше углубляйтесь по мере задач: документация python venv станет понятнее, когда появится реальный сценарий использования.

Насколько публикация полезна?

Нажмите на звезду, чтобы оценить!

Средняя оценка 0 / 5. Количество оценок: 0

Оценок пока нет. Поставьте оценку первым.

Поделиться: Telegram ВКонтакте