index.md
1> **Источник:** https://python-all.ru/3.4/installing/index.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# Установка модулей Python89| Эл. почта: | [distutils-sig@python.org](https://python-all.ru/3.4/installing/index.html) |10| --- | --- |1112Будучи популярным проектом с открытым исходным кодом, Python имеет активное сообщество разработчиков и пользователей, которые также предоставляют своё программное обеспечение другим разработчикам Python для использования на условиях открытых лицензий.1314Это позволяет пользователям Python эффективно обмениваться опытом и сотрудничать, извлекая пользу из решений, которые другие уже создали для общих (а иногда и редких!) проблем, а также потенциально внося свои собственные решения в общий пул.1516Это руководство описывает часть процесса, связанную с установкой. Чтобы узнать о создании и публикации собственных проектов Python, обратитесь к [*руководству по распространению*](https://python-all.ru/3.4/distributing/index.html#distributing-index).1718> **Примечание**19>20> Корпоративным и другим институциональным пользователям: следует знать, что многие организации имеют собственную политику в отношении использования и участия в программном обеспечении с открытым исходным кодом. Учитывайте такую политику при использовании инструментов распространения и установки, предоставляемых с Python.2122## Ключевые термины2324- `pip` – предпочтительная программа для установки пакетов. Начиная с Python 3.4, она по умолчанию входит в состав бинарных установщиков Python.25- Виртуальное окружение – это частично изолированная среда Python, позволяющая устанавливать пакеты для использования конкретным приложением, а не в масштабе всей системы.26- `pyvenv` – стандартный инструмент для создания виртуальных окружений, входящий в состав Python начиная с версии 3.3. Начиная с Python 3.4, он по умолчанию устанавливает `pip` во все создаваемые виртуальные окружения27- `virtualenv` – сторонняя альтернатива (и предшественник) инструмента `pyvenv`. Она позволяет использовать виртуальные окружения в версиях Python до 3.4, которые либо вообще не содержат `pyvenv`, либо не могут автоматически установить `pip` в создаваемые окружения.28- [Python Packaging Index](https://python-all.ru/3.4/installing/index.html) – это общедоступный репозиторий пакетов с открытым исходным кодом, доступных для использования другими пользователями Python29- [Python Packaging Authority](https://python-all.ru/3.4/installing/index.html) является группой разработчиков и авторов документации, отвечающих за поддержку и развитие стандартных инструментов упаковки, а также связанных метаданных и стандартов форматов файлов. Они поддерживают множество инструментов, документации и трекеров задач как на [GitHub](https://python-all.ru/3.4/installing/index.html) так и на [BitBucket](https://python-all.ru/3.4/installing/index.html).30- `distutils` – оригинальная система сборки и распространения, впервые добавленная в стандартную библиотеку Python в 1998 году. Хотя прямое использование `distutils` постепенно прекращается, она заложила основу для современной инфраструктуры упаковки и распространения. Она не только остаётся частью стандартной библиотеки, но и живёт в других проявлениях (например, в названии списка рассылки, используемого для координации разработки стандартов упаковки Python).3132## Базовое использование3334Все стандартные инструменты упаковки предназначены для использования из командной строки.3536Следующая команда установит последнюю версию модуля и его зависимости из Python Packaging Index:3738```text39python -m pip install SomePackage40```4142> **Примечание**43>44> Для пользователей POSIX (включая пользователей Mac OS X и Linux) примеры в этом руководстве предполагают использование [*виртуального окружения*](https://python-all.ru/3.4/glossary.html#term-virtual-environment).45>46> Для пользователей Windows примеры в этом руководстве предполагают, что параметр изменения системной переменной среды PATH был выбран при установке Python.4748Также можно указать точную или минимальную версию непосредственно в командной строке:4950```text51python -m pip install SomePackage==1.0.4 # specific version52python -m pip install 'SomePackage>=1.0.4' # minimum version53```5455Обычно, если подходящий модуль уже установлен, попытка установить его снова не даст результата. Обновление существующих модулей необходимо запрашивать явно:5657```text58python -m pip install --upgrade SomePackage59```6061Дополнительную информацию и ресурсы, касающиеся `pip` и его возможностей, можно найти в [Руководстве пользователя по упаковке Python](https://python-all.ru/3.4/installing/index.html).6263`pyvenv` имеет собственную документацию по адресу [*pyvenv – Создание виртуальных окружений*](https://python-all.ru/3.4/using/scripts.html#scripts-pyvenv). Для установки в активное виртуальное окружение используются команды, показанные выше.6465> **См. также**66>67> [Руководство пользователя по упаковке Python: установка дистрибутивных пакетов Python](https://python-all.ru/3.4/installing/index.html)6869## Как мне ...?7071Это краткие ответы или ссылки для некоторых распространённых задач.7273### ... установить `pip` в версиях Python до Python 3.4?7475Python начал включать `pip` в свой состав только с версии 3.4. Для более ранних версий `pip` требуется «начальная установка», как описано в Руководстве пользователя по упаковке Python.7677> **См. также**78>79> [Руководство пользователя по упаковке Python: Настройка для установки дистрибутивных пакетов](https://python-all.ru/3.4/installing/index.html)8081### ... установить пакеты только для текущего пользователя?8283Передача параметра `--user` команде `python -m pip install` установит пакет только для текущего пользователя, а не для всех пользователей системы.8485### ... установить научные пакеты Python?8687Ряд научных пакетов Python имеют сложные бинарные зависимости, и в настоящее время их непросто установить напрямую с помощью `pip`. На данном этапе пользователям зачастую будет проще установить такие пакеты [другими способами](https://python-all.ru/3.4/installing/index.html), чем пытаться устанавливать их с помощью `pip`.8889> **См. также**90>91> [Руководство пользователя по упаковке Python: установка научных пакетов](https://python-all.ru/3.4/installing/index.html)9293### ... работать с несколькими версиями Python, установленными параллельно?9495В Linux, Mac OS X и других POSIX-системах используйте версионированные команды Python в сочетании с флагом `-m` для запуска соответствующей копии `pip`:9697```text98python2 -m pip install SomePackage # default Python 299python2.7 -m pip install SomePackage # specifically Python 2.7100python3 -m pip install SomePackage # default Python 3101python3.4 -m pip install SomePackage # specifically Python 3.4102```103104(также могут быть доступны соответствующие версионированные команды `pip`)105106В Windows используйте программу запуска Python `py` в сочетании с флагом `-m` :107108```text109py -2 -m pip install SomePackage # default Python 2110py -2.7 -m pip install SomePackage # specifically Python 2.7111py -3 -m pip install SomePackage # default Python 3112py -3.4 -m pip install SomePackage # specifically Python 3.4113```114115## Распространённые проблемы установки116117### Установка в системный Python в Linux118119В системах Linux установка Python обычно входит в состав дистрибутива. Установка пакетов в эту установку Python требует прав root на систему и может нарушить работу системного менеджера пакетов и других компонентов системы, если какой-либо компонент будет неожиданно обновлён с помощью `pip`.120121В таких системах при установке пакетов с помощью `pip` зачастую лучше использовать виртуальное окружение или установку для каждого пользователя.122123### Установка бинарных расширений124125Python традиционно в значительной степени полагался на распространение в исходных кодах, предполагая, что конечные пользователи будут компилировать модули расширения из исходников в процессе установки.126127С введением поддержки бинарного формата `wheel` и возможности публиковать wheels как минимум для Windows и Mac OS X через Python Package Index, ожидается, что эта проблема со временем уменьшится, поскольку пользователи смогут чаще устанавливать готовые расширения, а не собирать их самостоятельно.128129Некоторые из решений для установки [научного программного обеспечения](https://python-all.ru/3.4/installing/index.html), которое ещё не доступно в виде готовых файлов `wheel`, также могут помочь получить другие бинарные расширения без необходимости сборки на локальной машине.130131> **См. также**132>133> [Руководство пользователя по упаковке Python: Бинарные расширения](https://python-all.ru/3.4/installing/index.html)134