Como limpar o cache do pip, conda e uv no Mac
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
- pip:
pip cache infopara medir epip cache purgepara esvaziar. - uv: comece com
uv cache prunee useuv cache cleanse precisar de mais. - conda: teste
conda clean --all --dry-rune depois rode sem essa opção. - Poetry:
poetry cache clear --all. - 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.