Установка модулей Python
Как популярный проект с открытым исходным кодом, Python располагает активным сообществом участников и пользователей, которые также предоставляют своё программное обеспечение другим разработчикам Python на условиях лицензий с открытым исходным кодом.
Это позволяет пользователям Python эффективно обмениваться решениями и сотрудничать, используя уже созданные другими решения распространённых (а иногда даже редких!) проблем, а также, возможно, внося собственные решения в общий пул.
В этом руководстве рассматривается этап установки. Руководство по созданию и распространению собственных проектов на Python см. в руководстве пользователя по упаковке Python.
Примечание
Корпоративным и другим институциональным пользователям следует учитывать, что во многих организациях действуют собственные правила использования программного обеспечения с открытым исходным кодом и участия в его разработке. При использовании инструментов распространения и установки, предоставляемых вместе с Python, учитывайте эти правила.
Основные термины
- pip — рекомендуемая программа установки. Она включена по умолчанию в двоичные установщики Python.
- Виртуальная среда — это частично изолированная среда Python, позволяющая устанавливать пакеты для использования конкретным приложением, а не для всей системы.
-
venv— стандартный инструмент для создания виртуальных сред. По умолчанию он устанавливает pip во все создаваемые виртуальные среды. -
virtualenv— сторонняя альтернатива (и предшественник)venv. - Индекс пакетов Python (PyPI) — общедоступный репозиторий пакетов с лицензиями на открытое исходное ПО, доступных другим пользователям Python.
- Python Packaging Authority — группа разработчиков и авторов документации, отвечающая за поддержку и развитие стандартных инструментов упаковки, а также связанных с ними стандартов метаданных и форматов файлов. Они поддерживают множество инструментов, документацию и системы отслеживания ошибок на GitHub.
Изменено в версии 3.5: Теперь для создания виртуальных сред рекомендуется использовать venv.
Основы использования
Все стандартные инструменты упаковки предназначены для использования из командной строки.
Следующая команда установит последнюю версию модуля и его зависимости из PyPI:
python -m pip install SomePackage
Примечание
Для пользователей POSIX (включая пользователей macOS и Linux) в примерах этого руководства предполагается использование виртуальной среды.
Для пользователей Windows в примерах этого руководства предполагается, что при установке Python был выбран параметр изменения системной переменной среды PATH.
Также можно указать в командной строке точную или минимальную версию. При использовании операторов сравнения, таких как >, <, или некоторых других специальных символов, которые интерпретируются оболочкой, имя пакета и версию следует заключать в двойные кавычки:
python -m pip install SomePackage==1.0.4 # specific version python -m pip install "SomePackage>=1.0.4" # minimum version
Как правило, если подходящий модуль уже установлен, повторная попытка его установки не приведёт к каким-либо изменениям. Запрос на обновление уже установленных модулей необходимо указывать явно:
python -m pip install --upgrade SomePackage
Дополнительные сведения о pip и его возможностях можно найти в руководстве пользователя по упаковке Python.
Виртуальные среды создаются с помощью модуля venv. Для установки пакетов в активную виртуальную среду используются приведённые выше команды.
Как …?
Ниже приведены краткие ответы и ссылки по некоторым распространённым задачам.
… установить пакеты только для текущего пользователя?
Передача параметра --user команде python -m pip install установит пакет только для текущего пользователя, а не для всех пользователей системы.
… установить научные пакеты Python?
Некоторые научные пакеты Python имеют сложные двоичные зависимости, и в настоящее время их нелегко установить напрямую с помощью pip. Пользователям часто проще установить эти пакеты другими способами, чем пытаться установить их с помощью pip.
… работать с несколькими версиями Python, установленными параллельно?
В Linux, macOS и других системах POSIX используйте команды Python с указанием версии вместе с параметром -m, чтобы запустить соответствующую копию pip:
python3 -m pip install SomePackage # default Python 3 python3.14 -m pip install SomePackage # specifically Python 3.14
Также могут быть доступны соответствующие версии команды pip.
В Windows используйте средство запуска Python py вместе с параметром -m:
py -3 -m pip install SomePackage # default Python 3 py -3.14 -m pip install SomePackage # specifically Python 3.14
Распространённые проблемы при установке
Установка в системный Python в Linux
В системах Linux установка Python обычно входит в состав дистрибутива. Для установки в эту версию Python требуются права root. Если компонент неожиданно обновляется с помощью pip, это может нарушить работу системного менеджера пакетов и других компонентов системы.
В таких системах при установке пакетов с помощью pip часто лучше использовать виртуальную среду или выполнять установку для отдельного пользователя.
Pip не установлен
Возможно, pip не устанавливается по умолчанию. Один из возможных способов решения:
python -m ensurepip --default-pip
Дополнительные сведения об установке pip также доступны.
Установка двоичных расширений
Раньше Python в значительной степени полагался на распространение исходного кода, предполагая, что конечные пользователи будут компилировать модули расширений из исходного кода в процессе установки.
С появлением двоичного формата wheel и возможностью публикации wheel-файлов через PyPI эта проблема постепенно исчезает: пользователи всё чаще могут устанавливать предварительно собранные расширения, вместо того чтобы собирать их самостоятельно.
Некоторые решения для установки научного программного обеспечения, которое пока недоступно в виде предварительно собранных wheel-файлов, также могут помочь получить другие двоичные расширения, не собирая их локально.
© 2001 Python Software Foundation
Licensed under the PSF License.
https://docs.python.org/3.14/installing/index.html
