Как установить библиотеку в Python через pip

Чтобы установить библиотеку в Python, откройте терминал (не интерпретатор Python) и выполните python -m pip install имя_библиотеки. pip скачает пакет с PyPI вместе с зависимостями, после чего его можно импортировать в коде.

python -m pip install requests      # Windows (или: py -m pip install requests)
python3 -m pip install requests     # macOS и Linux

Ниже — пошаговая установка в виртуальное окружение, установка из requirements.txt и конкретной версии, работа в PyCharm, VS Code и Jupyter, а также разбор ситуации «установил, а import не работает».

Откройте терминал операционной системы

Команды pip выполняются в командной строке операционной системы:

• Windows — cmd, PowerShell или Windows Terminal;
• macOS — приложение «Терминал»;
• Linux — любой эмулятор терминала;
• в IDE — встроенная вкладка Terminal.

Частая ошибка новичков — вводить pip install в интерактивном Python (строка начинается с >>>). Интерпретатор понимает только Python-код, поэтому отвечает синтаксической ошибкой:

>>> pip install requests
  File "<stdin>", line 1
    pip install requests
        ^^^^^^^
SyntaxError: invalid syntax

Выйдите из интерпретатора командой exit() и повторите команду в обычном терминале.

Создайте и активируйте виртуальное окружение

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

python -m venv .venv
.venv\Scripts\activate           # Windows, cmd
.venv\Scripts\Activate.ps1       # Windows, PowerShell
source .venv/bin/activate        # macOS и Linux

После активации в начале строки терминала появится (.venv), а команды python и pip будут относиться к окружению.

Установите библиотеку командой pip install

python -m pip install requests

Вывод заканчивается строкой со списком установленных пакетов — сама библиотека и её зависимости:

Installing collected packages: urllib3, idna, charset-normalizer, certifi, requests
Successfully installed certifi-2026.7.22 charset-normalizer-3.5.2 idna-3.20 requests-2.34.2 urllib3-2.8.0

Несколько библиотек можно поставить одной командой:

python -m pip install pandas matplotlib openpyxl

Почему python -m pip, а не просто pip: так пакет гарантированно попадёт в тот интерпретатор, который вы будете запускать. Подробнее об этом и о других командах — в статье pip в Python: установка, обновление и основные команды.

Проверьте установку

Самая честная проверка — импортировать библиотеку тем же интерпретатором:

python -c "import requests; print(requests.__version__)"

2.34.2

Атрибут __version__ есть не у всех библиотек. Универсальный способ — стандартный модуль importlib.metadata или pip show:

from importlib.metadata import version

print(version("requests"))  # → 2.34.2

python -m pip show requests

В выводе pip show проверьте строку Location: она показывает, в какую папку site-packages установлен пакет — в окружение проекта или в системный Python.

Как установить конкретную версию библиотеки

python -m pip install django==5.2.18          # точная версия
python -m pip install "django>=5.2,<6.0"      # последняя из ветки 5.2 LTS
python -m pip install --upgrade requests      # обновить до последней

Условия с < и > заключайте в кавычки: без них терминал воспримет эти символы как перенаправление. Если указанной версии нет, pip выведет No matching distribution found и список доступных версий.

Установка библиотек из requirements.txt

requirements.txt — текстовый файл со списком зависимостей проекта, по одной на строку:

django==5.2.18
requests>=2.32
python-dotenv

Установить всё разом:

python -m pip install -r requirements.txt

Создать такой файл из текущего окружения — python -m pip freeze > requirements.txt. Обычно в репозитории хранят именно его, а не папку окружения.

Как установить библиотеку в PyCharm

1. Убедитесь, что у проекта выбран нужный интерпретатор: Settings → Project: имя_проекта → Python Interpreter. Для нового проекта PyCharm по умолчанию создаёт виртуальное окружение.
2. Установите пакет одним из способов:
   • нажмите + в списке пакетов окна Python Interpreter, найдите библиотеку и нажмите Install Package;
   • откройте окно Python Packages (View → Tool Windows → Python Packages) и найдите пакет через поиск;
   • наведите курсор на подчёркнутый импорт в редакторе и выберите предложенное действие установки пакета;
   • выполните python -m pip install имя во вкладке Terminal — PyCharm открывает её с активированным окружением проекта.

Названия пунктов меню немного отличаются между версиями PyCharm, но логика одна: пакет ставится в интерпретатор, выбранный для проекта.

Как установить библиотеку в VS Code

VS Code ставит пакеты в выбранный интерпретатор — через встроенный терминал или через расширение Python Environments.

1. Нажмите Ctrl+Shift+P → Python: Select Interpreter и выберите интерпретатор из .venv проекта.
2. Откройте терминал: Terminal → New Terminal (Ctrl+`). Убедитесь, что в начале строки есть (.venv).
3. Выполните python -m pip install имя.

Если включено расширение Python Environments, без терминала то же делает команда Python Envs: Manage Packages из палитры команд: в ней можно найти пакет по имени или установить зависимости из requirements.txt.

Если код по-прежнему подчёркивает импорт, проверьте, что в правом нижнем углу окна выбран тот же интерпретатор, в который вы ставили пакет.

Установка в Jupyter Notebook

В ячейке ноутбука используйте магическую команду %pip — она ставит пакет в окружение текущего ядра:

%pip install pandas

Вариант !pip install запускает тот pip, который первым найдётся в PATH, и может поставить библиотеку в другой Python. После установки иногда нужно перезапустить ядро (Kernel → Restart).

Установка без интернета из wheel-файлов

Если на целевой машине нет доступа к PyPI, скачайте пакеты с зависимостями на компьютере с интернетом:

python -m pip download requests -d wheels

Перенесите папку wheels и установите из неё, запретив обращение к индексу:

python -m pip install --no-index --find-links wheels requests

Отдельный wheel можно поставить и напрямую: python -m pip install wheels\requests-2.34.2-py3-none-any.whl. Учитывайте, что wheel-файлы с бинарным кодом привязаны к версии Python и ОС (например, cp312-cp312-win_amd64), поэтому скачивать их нужно под ту же платформу.

Частые ошибки

Установил библиотеку, но ModuleNotFoundError

Самая частая ситуация: pip поставил пакет в один Python, а скрипт запускается другим — системным вместо venv, Python 3.11 вместо 3.12 или интерпретатором IDE. Сравните пути:

python -m pip --version
python -c "import sys; print(sys.executable)"

В скрипте добавьте import sys; print(sys.executable) — путь должен совпадать с тем, куда ставился пакет. Если не совпадает, установите пакет нужным интерпретатором (путь\к\python.exe -m pip install ...) или выберите правильный интерпретатор в IDE. Все причины и решения собраны в статье ModuleNotFoundError: No module named.

Имя пакета не совпадает с именем модуля

Устанавливается одно имя, импортируется другое:

Установка (pip install)	Импорт (import)
opencv-python	cv2
Pillow	PIL
scikit-learn	sklearn
python-dotenv	dotenv
beautifulsoup4	bs4
PyYAML	yaml

Команда pip install cv2 завершится ошибкой No matching distribution found for cv2. Правильное имя для установки ищите на pypi.org или в документации библиотеки — например, в статье про OpenCV в Python.

«pip» не является внутренней или внешней командой

Папка Scripts не добавлена в PATH. Используйте py -m pip install имя или python -m pip install имя — разбор ошибки есть в статье про pip.

Microsoft Visual C++ 14.0 or greater is required

pip не нашёл готового wheel под вашу версию Python и пытается собрать пакет из исходников, для чего в Windows нужен компилятор. Чаще всего так бывает, если Python слишком новый и библиотека ещё не выпустила под него сборку. Варианты: обновить pip и библиотеку до последней версии, использовать версию Python, для которой есть wheel, или установить Microsoft C++ Build Tools.

Частые вопросы

Как удалить установленную библиотеку?

Выполните python -m pip uninstall имя и подтвердите удаление (флаг -y пропускает вопрос). Зависимости, которые pip поставил вместе с библиотекой, при этом остаются; если окружение нужно очистить полностью, проще пересоздать его из requirements.txt.

Как обновить все библиотеки сразу?

Отдельной команды для этого в pip нет. Посмотрите устаревшие пакеты командой python -m pip list --outdated и обновите нужные через python -m pip install --upgrade имя. Обновлять всё подряд в рабочем проекте рискованно: новая мажорная версия может сломать код, поэтому после обновления запустите тесты и пересохраните requirements.txt.

Что делать с ошибкой externally-managed-environment?

Её выдают системный Python в свежих Debian и Ubuntu и Python из Homebrew: они запрещают ставить пакеты через pip в обход менеджера пакетов ОС. Создайте виртуальное окружение и устанавливайте библиотеку в него. Консольные программы вроде black или httpie удобнее ставить через pipx, а библиотеки для системных скриптов — пакетами дистрибутива (sudo apt install python3-requests).

Как установить библиотеку для конкретной версии Python?

Вызовите pip через нужный интерпретатор: в Windows — py -V:3.13 -m pip install requests, в macOS и Linux — python3.13 -m pip install requests. В виртуальном окружении версия уже выбрана при его создании, там достаточно python -m pip install.

Как установить библиотеку через прокси или зеркало PyPI?

Адрес прокси передают флагом --proxy в формате http://пользователь:пароль@хост:порт, а другой индекс пакетов — флагом --index-url (-i):

python -m pip install requests --proxy http://proxy.local:3128
python -m pip install requests -i https://mirror.example.com/simple

Чтобы не повторять флаги, их можно сохранить в конфигурации pip командой python -m pip config set global.index-url адрес.

Итог

Библиотеки ставятся из терминала командой python -m pip install имя — лучше в активированное виртуальное окружение проекта. Проверяйте результат импортом тем же интерпретатором, а при ModuleNotFoundError первым делом сравнивайте sys.executable с путём установки. Что ставить дальше — в обзоре популярных библиотек Python, например requests и pandas; остальные статьи об окружении — в разделе «Установка и окружение».