Как создать и активировать виртуальную среду Python

Узнайте, как создавать, активировать виртуальную среду Python и управлять ею с помощью встроенного модуля venv. Держите зависимости вашего проекта изолированными и чистыми.

Попробуйте это решение в редакторе

Обзор

При разработке приложений Python вы часто устанавливаете сторонние пакеты с помощью pip. Без виртуальной среды эти пакеты устанавливаются глобально в среде Python вашей системы. Это может быстро привести к конфликтам, если разные проекты требуют разных версий одной и той же библиотеки (например, проекту A требуетсяDjango3.2, а проекту B требуетсяDjango5.0).

Виртуальная среда — это изолированный каталог, содержащий собственный исполняемый файл Python и собственный набор установленных пакетов. Создавая виртуальную среду для каждого из ваших проектов, вы гарантируете, что установка пакетов не будет мешать другим проектам или общесистемной настройке Python. Это фундаментальная передовая практика разработки Python.

В современнойPython 3стандартная библиотека включает модуль venv, который обрабатывает виртуальные среды без необходимости использования внешних инструментов. Жизненный цикл виртуальной среды включает в себя создание каталога среды, его активацию в активном сеансе терминала, установку зависимостей и, в конечном итоге, его деактивацию по завершении.

Код и вывод выполнения

В этом моделировании отображаются команды терминала, используемые для создания, активации, установки пакетов и деактивации виртуальной среды в macOS/Linux и Windows.

commands_macos_linux = """
# 1. Create a virtual environment named 'venv'
$ python3 -m venv venv

# 2. Activate the virtual environment
$ source venv/bin/activate

# 3. Verify activation (will show the path to the virtual env's python)
(venv) $ which python

# 4. Deactivate when done
(venv) $ deactivate
"""

commands_windows = """
# 1. Create a virtual environment named 'venv'
> python -m venv venv

# 2. Activate the virtual environment in Command Prompt
> venv\Scripts\activate

# 3. Or activate in PowerShell
> .\venv\Scripts\Activate.ps1

# 4. Deactivate when done
(venv) > deactivate
"""

print("macOS & Linux terminal commands:")
print(commands_macos_linux.strip())
print("\nWindows terminal commands:")
print(commands_windows.strip())
Терминальный выход
macOS & Linux terminal commands:
# 1. Create a virtual environment named 'venv'
$ python3 -m venv venv

# 2. Activate the virtual environment
$ source venv/bin/activate

# 3. Verify activation (will show the path to the virtual env's python)
(venv) $ which python

# 4. Deactivate when done
(venv) $ deactivate

Windows terminal commands:
# 1. Create a virtual environment named 'venv'
> python -m venv venv

# 2. Activate the virtual environment in Command Prompt
> venv\Scripts\activate

# 3. Or activate in PowerShell
> .\venv\Scripts\Activate.ps1

# 4. Deactivate when done
(venv) > deactivate

Пошаговая реализация

  • Запустите python -m venv <env_name> в терминале проекта, чтобы сгенерировать файлы среды.
  • Активируйте среду, используя источник <имя_окружения>/bin/activate (macOS/Linux) или <имя_окружения>\Scripts\activate (Windows).
  • Установите необходимые пакеты с помощью pip install, чтобы убедиться, что они изолированы от этого каталога проекта.
  • Введите deactivate в оболочке терминала, чтобы выйти из виртуальной среды после завершения работы.

Часто задаваемые вопросы

Где мне следует создать папку виртуальной среды?

Создайте его непосредственно в корневом каталоге вашего проекта. Избегайте фиксации папки виртуальной среды (например, venv/) в Git, добавляя ее в файл .gitignore.

Что на самом деле дает активация виртуальной среды?

Активация временно обновляет переменную PATH вашей оболочки, указывая ее на папку bin или Scripts виртуальной среды, чтобы запускались локальные исполняемые файлы python и pip, а не общесистемные.

Связанные темы

Рекомендуемые ресурсы Python

Расширьте свои знания с помощью соответствующих интерактивных руководств, шпаргалок и сравнений кода.