Caches do npm e do pnpm: onde os gigabytes se escondem no AppData

Duas ferramentas, dois modelos de cache

O npm mantém um cache endereçável por conteúdo em %LOCALAPPDATA%\npm-cache: cada tarball já baixado, mais logs e o cache _npx das execuções pontuais de pacotes. Nada disso é necessário para que os projetos instalados continuem funcionando — o cache existe apenas para acelerar instalações futuras e viabilizar o trabalho offline. O pnpm resolve de outro jeito: um repositório único (nas versões recentes, %LOCALAPPDATA%\pnpm\store) guarda os arquivos de verdade, e cada pasta node_modules de cada projeto é construída com vínculos físicos para ele. É por isso que projetos no pnpm não multiplicam o consumo de disco como os do npm — e é por isso que o próprio store cresce sem limite: cada versão nova de pacote fica lá para sempre até você limpar.

Daí a surpresa conhecida: você apaga um projeto velho e o espaço não volta, porque os vínculos físicos do store continuam mantendo os dados vivos. Quem precisa de atenção é o store, não as pastas dos projetos.

Os comandos de limpeza que valem a pena

Tudo aqui é seguro por definição: caches são caches, e as ferramentas os reconstroem sob demanda:

• npm cache clean --force — esvazia todo o cache do npm; as próximas instalações baixam de novo o que precisarem
• npm cache verify — a opção suave: coleta lixo e verifica integridade em vez de varrer tudo
• pnpm store prune — remove do repositório os pacotes a que nenhum projeto ainda aponta
• Apagar %LOCALAPPDATA%\npm-cache\_npx — caches descartáveis das execuções do npx, sempre seguro
• npm config set cache D:\dev\npm-cache — muda o cache do SSD para um disco de dados, de vez
• Meça antes: um escaneamento de tamanho no AppData ganha do apagar às cegas — npm-cache e o store do pnpm são os dois suspeitos de sempre

A pegadinha dos vínculos físicos no NTFS

Agora a parte que confunde todo mundo: no NTFS, os dados de um arquivo só são liberados quando o último vínculo físico a ele desaparece. Apagar o store do pnpm logo depois de limpar o node_modules devolve o espaço esperado. Apagar o store enquanto os projetos ainda apontam para os arquivos dele não libera nada: os bytes ficam no disco enquanto o node_modules existir, e o Explorador continua mostrando entradas do store que na prática são cascas vazias. A ordem importa: primeiro remova os projetos (ou os node_modules deles), depois rode pnpm store prune. Runners de CI e máquinas que atravessam muitos repositórios são as que mais lucram com uma passada mensal; num notebook de projeto único, o store raramente merece atenção.

Perguntas e respostas

Continue lendo