`venv.md`

168 строк · 11.5 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.13/tutorial/venv.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 12. Виртуальные окружения и пакеты89## 12.1. Введение1011Приложения на Python часто используют пакеты и модули, не входящие в стандартную библиотеку. Иногда приложению требуется конкретная версия библиотеки, потому что оно может зависеть от исправления определённой ошибки или быть написано с использованием устаревшей версии интерфейса библиотеки.1213Это означает, что одна установка Python может не удовлетворять требованиям всех приложений. Если приложению A нужна версия 1.0 определённого модуля, а приложению B – версия 2.0, то требования противоречат друг другу, и установка либо версии 1.0, либо 2.0 оставит одно из приложений неработоспособным.1415Решением этой проблемы является создание [виртуального окружения](https://python-all.ru/3.13/glossary.html#term-virtual-environment) – изолированного дерева каталогов, содержащего установку Python определённой версии, а также ряд дополнительных пакетов.1617Разные приложения могут затем использовать разные виртуальные окружения. Чтобы разрешить упомянутый ранее конфликт требований, приложение A может иметь собственное виртуальное окружение с установленной версией 1.0, а приложение B – другое виртуальное окружение с версией 2.0. Если приложению B потребуется обновить библиотеку до версии 3.0, это не повлияет на окружение приложения A.1819## 12.2. Создание виртуальных окружений2021Модуль, используемый для создания и управления виртуальными окружениями, называется [`venv`](https://python-all.ru/3.13/library/venv.html#module-venv). `venv` установит версию Python, из которой была запущена команда (как указано опцией [`--version`](https://python-all.ru/3.13/using/cmdline.html#cmdoption-version)). Например, выполнение команды с `python3.12` установит версию 3.12.2223Чтобы создать виртуальное окружение, выберите каталог, в котором вы хотите его разместить, и запустите модуль [`venv`](https://python-all.ru/3.13/library/venv.html#module-venv) как скрипт, указав путь к каталогу:2425```python26python -m venv tutorial-env27```2829Это создаст каталог `tutorial-env`, если его ещё нет, а также создаст внутри него каталоги, содержащие копию интерпретатора Python и различные вспомогательные файлы.3031Обычное расположение каталога для виртуального окружения – `.venv`. Это имя обычно скрывает каталог в вашей оболочке и не мешает, одновременно давая название, объясняющее, зачем этот каталог существует. Оно также предотвращает конфликт с файлами определения переменной окружения `.env`, которые поддерживаются некоторыми инструментами.3233После создания виртуального окружения его можно активировать.3435В Windows выполните:3637```python38tutorial-env\Scripts\activate39```4041В Unix или macOS выполните:4243```python44source tutorial-env/bin/activate45```4647(Этот скрипт написан для оболочки bash. Если вы используете оболочки **csh** или **fish**, существуют альтернативные скрипты `activate.csh` и `activate.fish`, которые следует использовать вместо него.)4849Активация виртуального окружения изменит приглашение оболочки, чтобы показывать, какое виртуальное окружение используется, и изменит окружение так, что запуск `python` будет использовать именно эту версию и установку Python. Например:5051```bash52$ source ~/envs/tutorial-env/bin/activate53(tutorial-env) $ python54Python 3.5.1 (default, May  6 2016, 10:59:36)55  ...56>>> import sys57>>> sys.path58['', '/usr/local/lib/python35.zip', ...,59'~/envs/tutorial-env/lib/python3.5/site-packages']60>>>61```6263Обратите внимание, что активированное виртуальное окружение никак не изменяет переменную `PYTHONPATH`. Это может привести к неожиданным результатам, если путь содержит ссылки на код, несовместимый с версией Python, используемой виртуальным окружением. Рекомендуется `unset PYTHONPATH` в bash или аналогично для используемой вами оболочки.6465Чтобы деактивировать виртуальное окружение, введите:6667```python68deactivate69```7071в терминале.7273## 12.3. Управление пакетами с помощью pip7475Вы можете устанавливать, обновлять и удалять пакеты с помощью программы **pip**. По умолчанию `pip` устанавливает пакеты из [Python Package Index](https://python-all.ru/3.13/tutorial/venv.html). Вы можете просматривать Python Package Index, перейдя на него в веб-браузере.7677`pip` имеет ряд подкоманд: «install», «uninstall», «freeze» и т. д. (Обратитесь к руководству [«Установка модулей Python»](https://python-all.ru/3.13/installing/index.html#installing-index) за полной документацией по `pip`.)7879Вы можете установить последнюю версию пакета, указав его имя:8081```bash82(tutorial-env) $ python -m pip install novas83Collecting novas84  Downloading novas-3.1.1.3.tar.gz (136kB)85Installing collected packages: novas86  Running setup.py install for novas87Successfully installed novas-3.1.1.388```8990Вы также можете установить конкретную версию пакета, указав имя пакета, затем `==` и номер версии:9192```bash93(tutorial-env) $ python -m pip install requests==2.6.094Collecting requests==2.6.095  Using cached requests-2.6.0-py2.py3-none-any.whl96Installing collected packages: requests97Successfully installed requests-2.6.098```99100Если вы повторно выполните эту команду, `pip` заметит, что запрошенная версия уже установлена, и ничего не сделает. Вы можете указать другой номер версии, чтобы получить её, или выполнить `python -m pip install --upgrade` для обновления пакета до последней версии:101102```bash103(tutorial-env) $ python -m pip install --upgrade requests104Collecting requests105Installing collected packages: requests106  Found existing installation: requests 2.6.0107    Uninstalling requests-2.6.0:108      Successfully uninstalled requests-2.6.0109Successfully installed requests-2.7.0110```111112`python -m pip uninstall` с одним или несколькими именами пакетов удалит пакеты из виртуального окружения.113114`python -m pip show` отобразит информацию о конкретном пакете:115116```bash117(tutorial-env) $ python -m pip show requests118---119Metadata-Version: 2.0120Name: requests121Version: 2.7.0122Summary: Python HTTP for Humans.123Home-page: http://python-requests.org124Author: Kenneth Reitz125Author-email: me@kennethreitz.com126License: Apache 2.0127Location: /Users/akuchling/envs/tutorial-env/lib/python3.4/site-packages128Requires:129```130131`python -m pip list` отобразит все пакеты, установленные в виртуальном окружении:132133```bash134(tutorial-env) $ python -m pip list135novas (3.1.1.3)136numpy (1.9.2)137pip (7.0.3)138requests (2.7.0)139setuptools (16.0)140```141142`python -m pip freeze` создаст аналогичный список установленных пакетов, но вывод использует формат, который ожидает `python -m pip install`. Общепринятая практика – помещать этот список в файл `requirements.txt`:143144```bash145(tutorial-env) $ python -m pip freeze > requirements.txt146(tutorial-env) $ cat requirements.txt147novas==3.1.1.3148numpy==1.9.2149requests==2.7.0150```151152Затем файл `requirements.txt` можно зафиксировать в системе контроля версий и распространять как часть приложения. Пользователи затем могут установить все необходимые пакеты с помощью `install -r`:153154```bash155(tutorial-env) $ python -m pip install -r requirements.txt156Collecting novas==3.1.1.3 (from -r requirements.txt (line 1))157  ...158Collecting numpy==1.9.2 (from -r requirements.txt (line 2))159  ...160Collecting requests==2.7.0 (from -r requirements.txt (line 3))161  ...162Installing collected packages: novas, numpy, requests163  Running setup.py install for novas164Successfully installed novas-3.1.1.3 numpy-1.9.2 requests-2.7.0165```166167`pip` имеет гораздо больше возможностей. Обратитесь к руководству [Установка модулей Python](https://python-all.ru/3.13/installing/index.html#installing-index) для получения полной документации по `pip`. Когда вы напишете пакет и захотите сделать его доступным в Python Package Index, обратитесь к [Руководству пользователя по упаковке Python](https://python-all.ru/3.13/tutorial/venv.html).168