Программирование · IT-курсы · 4 мин чтения

Зачем проекту Python отдельное виртуальное окружение?

Редакция Алгоса · Обновлено

Короткий ответ

Виртуальное окружение — отдельная папка с настройками запуска Python и установленными для проекта пакетами. Пакет — библиотека, которую можно подключить в программу. Окружение помогает одному проекту использовать одну версию библиотеки, а другому другую. Оно не является отдельным компьютером и не делает запуск незнакомого кода безопасным.

Как это устроено

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

Сравни действия и их результат
СлойЧто в нём находится
Исходники проектаТвои файлы программы
Окружение .venvВыбранный Python и пакеты
Описание зависимостейСписок нужных библиотек

Разберём на примере

В папке проекта выполни python -m venv .venv. Команда создаст окружение; конкретное имя запуска Python зависит от системы. Затем выбирай его интерпретатор в редакторе или запускай его напрямую. Интерпретатор — программа, выполняющая код Python. Активация окружения временно меняет поиск команд в терминале, но не переносит библиотеки между окружениями.

Пример по шагам

В Windows можно выполнить .venv\Scripts\python.exe -m pip list, чтобы увидеть пакеты именно этого окружения. В Linux и macOS аналогичный путь обычно .venv/bin/python. Для установки выбранного пакета используй тот же интерпретатор и -m pip install с именем пакета.

Почему так

Команда pip без уточнения может относиться к другому Python, особенно если их установлено несколько. Запись python -m pip запускает pip через выбранный интерпретатор. Чтобы проверить выбор, выведи import sys; print(sys.executable). Путь должен вести к окружению твоего проекта.

Проверь себя

Ты установил библиотеку в окружение игры, но редактор сообщает ModuleNotFoundError. Какую проверку сделать первой? Сравни Python, которым ставил пакет, с Python, которым запускается программа. Передавать другому человеку всю папку .venv обычно не нужно: окружение воспроизводят из описания зависимостей под его систему.

Ответ и объяснение

Сначала проверь sys.executable в запуске редактора. Если путь другой, выбери правильный интерпретатор или установи пакет в требуемое окружение. Повторная установка наугад в общую систему не объясняет причину. Код проекта и список его зависимостей стоит хранить отдельно от созданного окружения.

Что запомнить

Запускай проект и устанавливай его пакеты одним выбранным Python; проверяй путь через sys.executable.

Попробовать на Алгосе

Программирование на Python

В курсе ты освоишь переменные, условия, циклы, списки и функции Python; они помогут разобраться с этим приёмом.

Перейти к курсу Все курсы

Источники и материалы

Разобраться дальше

Все вопросы и разборы