index.md

1> **Источник:** https://python-all.ru/3.13/installing/index.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# Установка модулей Python89Будучи популярным проектом с открытым исходным кодом, Python имеет активное поддерживающее сообщество участников и пользователей, которые также делают своё программное обеспечение доступным для использования другими разработчиками Python на условиях открытых лицензий.1011Это позволяет пользователям Python эффективно обмениваться опытом и сотрудничать, извлекая пользу из решений, которые другие уже создали для общих (а иногда и редких!) проблем, а также потенциально внося свои собственные решения в общий пул.1213Это руководство описывает часть процесса, связанную с установкой. За руководством по созданию и распространению собственных проектов Python обращайтесь к [Руководству пользователя по упаковке Python](https://python-all.ru/3.13/installing/index.html).1415> **Примечание**16>17> Корпоративным и другим институциональным пользователям: следует знать, что многие организации имеют собственную политику в отношении использования и участия в программном обеспечении с открытым исходным кодом. Учитывайте такую политику при использовании инструментов распространения и установки, предоставляемых с Python.1819## Ключевые термины2021- **pip** – предпочтительная программа установки. Она по умолчанию входит в состав двоичных установщиков Python.22- *Виртуальное окружение* – это полуизолированное окружение Python, которое позволяет устанавливать пакеты для использования конкретным приложением, а не в масштабе всей системы.23- `venv` – стандартный инструмент для создания виртуальных окружений. По умолчанию он устанавливает **pip** во все создаваемые виртуальные окружения.24- `virtualenv` – это сторонняя альтернатива (и предшественник) `venv`.25- [Индекс пакетов Python (PyPI)](https://python-all.ru/3.13/installing/index.html) – это общедоступный репозиторий пакетов с открытым исходным кодом, доступных для использования другими пользователями Python.26- [Python Packaging Authority](https://python-all.ru/3.13/installing/index.html) – это группа разработчиков и авторов документации, отвечающая за поддержку и развитие стандартных инструментов упаковки, а также соответствующих стандартов метаданных и форматов файлов. Они поддерживают различные инструменты, документацию и трекеры задач на [GitHub](https://python-all.ru/3.13/installing/index.html).2728Изменено в версии 3.5: Теперь для создания виртуальных окружений рекомендуется использовать `venv`.2930> **См. также**31>32> [Руководство пользователя по упаковке Python: создание и использование виртуальных окружений](https://python-all.ru/3.13/installing/index.html)3334## Базовое использование3536Все стандартные инструменты упаковки предназначены для использования из командной строки.3738Следующая команда установит последнюю версию модуля и его зависимости из PyPI:3940```shell41python -m pip install SomePackage42```4344> **Примечание**45>46> For POSIX users (including macOS and Linux users), the examples in this guide assume the use of a [virtual environment](https://python-all.ru/3.13/glossary.html#term-virtual-environment).47>48> Для пользователей Windows примеры в этом руководстве предполагают, что параметр изменения системной переменной среды PATH был выбран при установке Python.4950Также можно указать точную или минимальную версию непосредственно в командной строке. При использовании операторов сравнения, таких как `>`, `<` или других специальных символов, интерпретируемых оболочкой, имя пакета и версию следует заключать в двойные кавычки:5152```shell53python -m pip install SomePackage==1.0.4    # конкретная версия54python -m pip install "SomePackage>=1.0.4"  # минимальная версия55```5657Обычно, если подходящий модуль уже установлен, попытка установить его снова не даст результата. Обновление существующих модулей необходимо запрашивать явно:5859```shell60python -m pip install --upgrade SomePackage61```6263Дополнительную информацию и ресурсы о **pip** и его возможностях можно найти в [Руководстве пользователя по упаковке Python](https://python-all.ru/3.13/installing/index.html).6465Создание виртуальных окружений выполняется с помощью модуля [`venv`](https://python-all.ru/3.13/library/venv.html#module-venv). Установка пакетов в активное виртуальное окружение использует команды, показанные выше.6667> **См. также**68>69> [Руководство пользователя по упаковке Python: установка дистрибутивных пакетов Python](https://python-all.ru/3.13/installing/index.html)7071## Как …?7273Это краткие ответы или ссылки для некоторых распространённых задач.7475### … установить пакеты только для текущего пользователя?7677Передача параметра `--user` в `python -m pip install` установит пакет только для текущего пользователя, а не для всех пользователей системы.7879### … установить научные пакеты Python?8081Ряд научных пакетов Python имеют сложные двоичные зависимости и в настоящее время нелегко устанавливаются напрямую с помощью **pip**. Часто пользователям проще установить эти пакеты [другими способами](https://python-all.ru/3.13/installing/index.html), чем пытаться установить их с помощью **pip**.8283> **См. также**84>85> [Руководство пользователя по упаковке Python: установка научных пакетов](https://python-all.ru/3.13/installing/index.html)8687### … работать с несколькими версиями Python, установленными параллельно?8889В Linux, macOS и других POSIX-системах используйте версионированные команды Python в сочетании с ключом `-m` для запуска соответствующей копии **pip**:9091```shell92python3    -m pip install SomePackage  # Python 3 по умолчанию93python3.14 -m pip install SomePackage  # конкретно Python 3.1494```9596Также могут быть доступны соответствующим образом версионированные команды **pip**.9798В Windows используйте **py** – средство запуска Python – в сочетании с ключом `-m` :99100```shell101py -3    -m pip install SomePackage  # Python 3 по умолчанию102py -3.14 -m pip install SomePackage  # конкретно Python 3.14103```104105## Распространённые проблемы установки106107### Установка в системный Python в Linux108109В Linux-системах установка Python обычно является частью дистрибутива. Установка в эту установку Python требует прав root на систему и может помешать работе системного менеджера пакетов и других компонентов системы, если какой-либо компонент будет неожиданно обновлён с помощью **pip**.110111В таких системах зачастую лучше использовать виртуальное окружение или установку для одного пользователя при установке пакетов с помощью **pip**.112113### Pip не установлен114115Возможно, **pip** не устанавливается по умолчанию. Одно из возможных решений:116117```shell118python -m ensurepip --default-pip119```120121Существуют также дополнительные ресурсы для [установки pip](https://python-all.ru/3.13/installing/index.html).122123### Установка бинарных расширений124125В прошлом Python сильно полагался на распространение в исходных кодах, и от конечных пользователей ожидалась компиляция модулей расширения из исходников как часть процесса установки.126127С появлением бинарного формата wheel и возможности публиковать колеса через PyPI эта проблема уменьшается, так как пользователи всё чаще могут устанавливать готовые расширения, а не собирать их самостоятельно.128129Некоторые из решений для установки [научного ПО](https://python-all.ru/3.13/installing/index.html), которое ещё не доступно в виде готовых wheel-файлов, также могут помочь с получением других бинарных расширений без необходимости локальной сборки.130131> **См. также**132>133> [Руководство пользователя по упаковке Python: Бинарные расширения](https://python-all.ru/3.13/installing/index.html)134