Pip

Короткая памятка по Python-пакетам

Пакеты
без паники.

Создай отдельное окружение для проекта, ставь пакеты через pip и держи зависимости под контролем. Здесь только команды, которые нужны чаще всего.

Начать за минуту
01 /

Сначала окружение

Виртуальное окружение хранит пакеты проекта отдельно от системного Python и других проектов. Создай его в папке проекта.

Linux и macOS

Терминал в папке проекта:

python3 -m venv .venv
source .venv/bin/activate
python -m pip install requests

Windows PowerShell

PowerShell в папке проекта:

py -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install requests

Добавь .venv/ в .gitignore. Активация необязательна: если PowerShell её блокирует, запусти .\.venv\Scripts\python.exe -m pip напрямую. В примерах ниже окружение уже активировано.

02 /

Частые команды

Запускай pip через python -m pip: так команда использует тот же Python, что и твой проект.

Установить пакет

python -m pip install requests

Пакет попадёт в активное окружение.

Обновить пакет

python -m pip install --upgrade requests

Установит подходящую более новую версию.

Посмотреть, что установлено

python -m pip list
python -m pip show requests

Список пакетов и сведения об одном пакете.

Удалить пакет

python -m pip uninstall requests

pip попросит подтвердить удаление.

03 /

Зависимости проекта

requirements.txt позволяет перенести список пакетов в другое окружение или на другой компьютер.

Сохранить установленные версии

Снимок текущего окружения:

python -m pip freeze > requirements.txt

Установить из списка

В новом виртуальном окружении:

python -m pip install -r requirements.txt

pip freeze показывает установленные версии. Это полезный снимок, но не полноценный lock-файл.

04 /

Если не работает

Чаще всего проблема не в пакете, а в том, какой Python запустился.

«pip не найден»

Проверь python -m pip --version внутри окружения. В Windows вне окружения используй py -m pip --version.

«Пакет есть, импорт не работает»

Проверь, что установка и запуск программы используют один Python. Путь к pip покажет python -m pip --version.

«externally-managed-environment»

Системный Python защищён от изменений. Создай .venv и устанавливай пакеты в него, не обходя защиту.