Rivalry2

HTML Diff

0 added 0 removed

Original 2026-01-01

Modified 2026-02-26

1 Представим, что мы начинаем работу с несколькими проектами. В каждом проекте могут быть разные наборы зависимостей. Еще более тяжелый случай: разные проекты могут иметь в зависимостях разные версии одной и той же библиотеки.

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

3 <h2>Виртуальное окружение</h2>

4 Заглянем в директорию.venv:

5 Здесь нам важны две директории:binиlib. Вторая директория,lib/python3.XX/site-packagesвам уже знакома - в ней установлены все зависимости проекта. Тогда как в директории.venv/binлежит ссылка на интерпретатор Python. Для чего это нужно? Давайте сперва поставим библиотеку в наш проект.

6 Создадим новый файлmodule.py, импортируем библиотеку и сделаем пару вызовов:

7 Запустим наш модуль с кодом:

8 Почему же мы получили ошибку, ведь мы установили библиотеку в проект? Суть в том, что Python используется в операционной системе для запуска системных утилит. Зависимости этих утилит хранятся в/usr/lib/python3.XX/site-packages- директории общей для всей системы. И Python ищет зависимости в своих, системных директориях.

9 Но ставить зависимости проекта в системные директории нельзя, будут конфликты. Тогда мы можем поступить наоборот, и запустить Python из директории.venvнашего проекта. Для этого в ней и лежит ссылка на интерпретатор.

10 Сочетание директории с зависимостями (lib/python3.XX/site-packages) и ссылки на интерпретатор (bin/python3) называетсяокружением. Окружение системного Python называютглобальным окружением, а окружение проекта локальным или чаще всеговиртуальным окружением. Отсюда и название директории.venv-VirtualEnviroment.

11 Но каждый раз вызывать код указывая полный путь до интерпретатора внутри.venvутомительно. Потому существует механизм подмены пути автоматически -активация окружения. При активации в переменную PATH, подставляется путь до интерпретатора внутри.venv. Затем, когда мы вызовем команду python3, то запустится Python внутри окружения. А когда мы закончим работу в окружении, останется лишь вернуть прежний путь, или еще говорятдеактивироватьокружение, чтобы система продолжила использовать системный Python с его библиотеками.

12 В действительности этот процесс приходится выполнять так часто, что пакетные менеджеры его автоматизируют.

13 Команда uv run <команда> активирует окружение, выполняет команду в нем и деактивирует его. Так вся работа с окружением скрыта от нас. В дальнейшем все команды запуска кода и утилит в проекте мы будем выполнять через uv run.

14 Разные проекты могут требовать не только разных версий библиотек, но и разных версий Python. При этом обновлять Python, установленный в системе, нельзя - могут сломаться системные утилиты. К счастью, механизм окружений позволяет управлять не только зависимостями, но и интерпретаторами. Вместо ссылки на системный Python можно указать ссылку на другую, отдельно скачанную версию.

15 uv также автоматизирует этот процесс, по умолчанию uv использует ссылку на системный интерпретатор, но для многих команд можно указать версию Python через флаг --python:

16 Если указанной версии нет в системе, то uv скачает ее и будет использовать для текущего проекта. Системный Python это никак не затронет, так как интерпретатор проекта полностью изолирован.