Python PIP - pip cache - чистка кэша - список команд
Python PIP - pip cache - чистка кэша - список команд - 2026
pip cache dir - показывает путь к каталогу кэша pip pip cache info - выводит информацию о размере и содержимом кэша pip cache list - показывает все файлы, находящиеся в кэше pip cache list <пакет> - показывает кэш только указанного пакета pip cache remove <пакет> - удаляет кэш указанного пакета pip cache purge - полностью очищает кэш pip pip install --no-cache-dir ... - устанавливает пакет без использования и сохранения кэша pip download <пакет> - скачивает пакет в текущую директорию без установки pip cache help - показывает справку по командам cache
pip cache dir pip cache info pip cache list pip cache list requests pip cache remove requests pip cache purge pip install --no-cache-dir requests pip download requests pip cache help
Pip сохраняет скачанные HTTP-ответы и собранные пакеты (wheel-файлы) в локальном кэше. Это ускоряет повторные установки и уменьшает сетевой трафик. Если кэш занимает слишком много места или содержит неподходящий wheel-файл, его можно просмотреть либо очистить.
Важно: как запускать pip
Рекомендуемый способ — запускать pip через нужный интерпретатор Python:
python -m pip --version python -m pip cache info
Так команда точно относится к выбранной версии Python и виртуальному окружению.
| Операционная система | Рекомендуемый вызов |
|---|---|
| Linux / macOS | python -m pip …
|
| Windows | py -m pip …
|
Что pip хранит в кэше
| Тип данных | Назначение | Особенность |
|---|---|---|
| HTTP-кэш | Метаданные и ответы, полученные из PyPI или другого индекса пакетов. | Снижает число повторных сетевых запросов. |
| Кэш wheel-файлов | Готовые пакеты .whl, в том числе собранные pip из исходного кода.
|
Позволяет не скачивать или не собирать пакет повторно. |
Примечание: команды pip cache list и pip cache remove работают с wheel-кэшем. HTTP-кэш отдельно не выводится командой list; для полной очистки применяется pip cache purge.
Основные команды pip cache
| Команда | Назначение | Пример |
|---|---|---|
pip cache dir
|
Показывает путь к используемому каталогу кэша. | python -m pip cache dir
|
pip cache info
|
Выводит размер и сведения о частях кэша. | python -m pip cache info
|
pip cache list
|
Показывает wheel-файлы, сохранённые в кэше. | python -m pip cache list
|
pip cache list шаблон
|
Показывает wheel-файлы пакета или пакетов, подходящих под шаблон. | python -m pip cache list requests
|
pip cache remove шаблон
|
Удаляет из wheel-кэша файлы указанного пакета или пакетов. | python -m pip cache remove requests
|
pip cache purge
|
Полностью очищает wheel- и HTTP-кэш pip. | python -m pip cache purge
|
pip cache help
|
Показывает встроенную справку по подкомандам кэша. | python -m pip cache help
|
Вместо имени пакета можно использовать шаблон (glob), например:
python -m pip cache list "requests*" python -m pip cache remove "urllib3*"
Где находится кэш pip
Точное расположение зависит от ОС и настроек пользователя. Надёжнее всего определить его командой:
python -m pip cache dir
Стандартные пути:
| ОС | Типичный каталог кэша |
|---|---|
| Linux | ~/.cache/pip
|
| macOS | ~/Library/Caches/pip
|
| Windows | %LocalAppData%\pip\Cache
|
На Linux и современных версиях pip на macOS путь также может определяться переменной окружения XDG_CACHE_HOME.
Просмотр содержимого и размера кэша
Для быстрой проверки используйте:
python -m pip cache info
Команда покажет расположение кэша, размер HTTP-кэша, размер wheel-кэша и число сохранённых файлов.
Чтобы увидеть список wheel-файлов:
python -m pip cache list
Для поиска кэша одного пакета:
python -m pip cache list requests
По умолчанию выводятся имена файлов. Чтобы получить абсолютные пути:
python -m pip cache list --format=abspath
Удаление кэша одного пакета
Если нужно удалить сохранённые wheel-файлы только одного пакета, используйте:
python -m pip cache remove requests
Это удобно, если пакет был собран в неподходящем окружении или требуется заново скачать либо собрать его wheel-файл.
Важно: pip cache remove не очищает HTTP-кэш. Для удаления всех данных кэша используйте pip cache purge.
Полная очистка кэша pip
Чтобы освободить место и удалить весь кэш pip:
python -m pip cache purge
После этого pip не удаляет установленные пакеты и не изменяет виртуальные окружения. При следующей установке нужные файлы будут загружены или собраны заново.
| Действие | Команда | Что будет удалено |
|---|---|---|
| Удалить wheel-файлы одного пакета | python -m pip cache remove requests
|
Wheel-файлы, соответствующие requests
|
| Полностью очистить кэш | python -m pip cache purge
|
Wheel- и HTTP-кэш pip |
Установка пакета без использования кэша
Для разовой установки без чтения и записи в кэш добавьте параметр --no-cache-dir:
python -m pip install --no-cache-dir requests
Этот режим полезен, например, при диагностике проблемного пакета или в некоторых контейнерных сборках.
Однако отключать кэш постоянно обычно не стоит: установка может стать медленнее, а объём сетевых загрузок — больше.
Скачать пакет без установки
Команда pip download разрешает зависимости и скачивает дистрибутивы, но не устанавливает их. По умолчанию файлы сохраняются в текущую директорию.
python -m pip download requests
Скачать пакет в определённый каталог:
python -m pip download --dest ./packages requests
Скачать пакет без зависимостей:
python -m pip download --no-deps requests
Скачанные файлы можно использовать для офлайн-установки:
python -m pip install --no-index --find-links=./packages requests
Краткий список команд
python -m pip cache dir python -m pip cache info python -m pip cache list python -m pip cache list requests python -m pip cache list --format=abspath python -m pip cache remove requests python -m pip cache purge python -m pip install --no-cache-dir requests python -m pip download requests python -m pip cache help
См. также
