Logo do PruneoPruneo

Como limpar o cache do pip, conda e uv no Mac

Resposta curta

Rode pip cache purge para esvaziar o cache do pip, uv cache clean para o uv e conda clean --all para o conda (teste antes com --dry-run). Esses comandos não desinstalam o que já está nos seus ambientes, exceto a opção --force-pkgs-dirs do conda. Os ambientes virtuais antigos costumam ocupar mais espaço, e eles são removidos à parte.

O Python deixa arquivos em vários lugares do seu Mac: um cache para cada gerenciador de pacotes, uma .venv por projeto e versões do Python que você não usa mais. Cada gerenciador de pacotes tem o seu próprio comando de limpeza. Este guia reúne os comandos oficiais e explica o que cada um apaga e o que será baixado de novo.

Use só as seções das ferramentas que você tem instaladas.

pip

O pip guarda as respostas dos downloads e os wheels que ele constrói, para não ter que repetir o trabalho. No Mac, o cache fica em ~/Library/Caches/pip por padrão. Para ver onde ele está e quanto ocupa:

pip cache dir
pip cache info

Para apagá-lo, ou para remover só um pacote:

# Apaga todo o cache do pip
pip cache purge

# Apaga o que está guardado de um pacote, por exemplo numpy
pip cache remove numpy

O que está instalado nos seus ambientes continua igual. Você só perde a cópia guardada: a próxima instalação pode baixar esses pacotes de novo. Dependendo da sua configuração, o comando pode ser pip3. Todas as opções estão na documentação do pip cache.

uv

O uv também tem um cache global, normalmente em ~/.cache/uv no Mac. Para ver quanto ele ocupa:

du -sh "$(uv cache dir)"

Você tem três maneiras de limpá-lo:

# Remove só as entradas que não são mais usadas
uv cache prune

# Apaga o que está guardado de um pacote, por exemplo ruff
uv cache clean ruff

# Apaga o cache inteiro
uv cache clean

Comece com uv cache prune, que mantém o que você ainda usa. Testamos isso em um Mac com um ambiente pequeno: depois de uv cache clean, o pacote instalado continuou funcionando. As próximas coisas que você instalar serão baixadas de novo.

conda

O conda guarda pacotes baixados e tarballs. Com --dry-run você pode ver o que ele apagaria sem mexer em nada:

conda clean --all --dry-run

Se parecer certo, rode de verdade. Ele pede confirmação antes de apagar:

conda clean --all

Segundo a documentação do conda clean, --all remove o cache de índice, os pacotes não usados, os tarballs e os logs.

Para remover um ambiente inteiro que você não usa mais:

conda info --envs
conda env remove -n nome-do-ambiente

Poetry

Se você usa o Poetry, liste os caches e esvazie-os com os comandos da documentação dele:

poetry cache list
poetry cache clear --all

Os seus projetos continuam iguais. Os pacotes serão baixados de novo da próxima vez que você precisar deles.

Ambientes virtuais que você não usa mais

Os caches muitas vezes são só parte da história. Cada projeto com uma .venv guarda a sua própria cópia dos pacotes, e um ambiente com bibliotecas de ciência de dados ou de IA pode ficar grande. Para encontrá-los, troque ~/Projects pela sua pasta de projetos. Este comando só mede:

find ~/Projects -type d -name ".venv" -prune -exec du -sh {} +
# Dentro da pasta do projeto
rm -rf .venv

Para recriá-la, use python3 -m venv .venv e reinstale as dependências, ou uv sync se o projeto usa uv.

Versões do Python que você não usa mais

Cada versão instalada ocupa o seu próprio espaço. Antes de remover uma, confira se nenhum projeto precisa dela:

# Com uv
uv python list --only-installed
uv python uninstall 3.11

# Com pyenv
pyenv versions
pyenv uninstall 3.11.9

Troque o número por uma versão da sua lista. Não mexa no Python em /usr/bin nem no do macOS: ele pertence ao sistema ou às ferramentas da Apple.

Resumo

  1. pip: pip cache info para medir e pip cache purge para esvaziar.
  2. uv: comece com uv cache prune e use uv cache clean se precisar de mais.
  3. conda: teste conda clean --all --dry-run e depois rode sem essa opção.
  4. Poetry: poetry cache clear --all.
  5. Ambientes e versões: apague os que você não usa, depois de conferir que consegue recriá-los.

Se você também usa Node, leia Como limpar node_modules e o cache do npm, pnpm e yarn. Para containers, veja Docker prune no Mac. Ou baixe o Pruneo de graça.

Perguntas frequentes

É seguro rodar pip cache purge?

Sim. Ele apaga os downloads e os wheels que o pip guarda para reutilizar. Os pacotes instalados nos seus ambientes continuam no lugar. A próxima instalação pode demorar mais, porque o pip baixa tudo de novo.

Onde o pip guarda o cache no Mac?

Por padrão em ~/Library/Caches/pip. Rode pip cache dir para ver o caminho exato no seu Mac e pip cache info para ver quanto ele ocupa.

Qual é a diferença entre uv cache clean e uv cache prune?

uv cache clean apaga o cache inteiro, ou as entradas de um pacote se você disser o nome dele. uv cache prune apaga só as entradas que não são mais usadas, então libera menos espaço, mas evita baixar de novo o que você ainda usa.

O conda clean --all quebra os meus ambientes?

Não deve quebrar os ambientes que o conda tem registrados: ele remove pacotes não usados, tarballs, caches de índice e logs. Tenha cuidado se você tem ambientes que não aparecem em conda info --envs, e não use --force-pkgs-dirs sem ler o aviso dessa opção.

Experimente com o Pruneo

Grátis para macOS 14 ou posterior. Tudo o que ele limpa pode ser recuperado na quarentena.

Pruneo é para Mac

Envie o link para você e baixe no seu Mac. É grátis e sem conta.

Enviar por e-mail
Baixar mesmo assim