A guerra do node_modules: recuperando gigas de projetos mortos

Por que uma pasta pesa mais que o seu sistema operacional

O npm instala cada dependência num node_modules local, por projeto — sem compartilhamento e sem deduplicação entre projetos, por padrão. Um web app modesto puxa com facilidade 800 MB a 2 GB em mil pacotes, e o verdadeiro assassino é a contagem de arquivos: dezenas de milhares de pequenezas que o Windows Defender escaneia, que as ferramentas de backup rastejam e nas quais o OneDrive — se seus projetos vivem numa pasta sincronizada — engasga eternamente. É também por isso que instalar no Windows leva minutos e no Linux segundos: o custo por arquivo pequeno é brutal. Cinco experimentos abandonados depois, você está olhando para 10–15 GB que nada usa.

Apague sem medo: o lockfile é a sua garantia

O contrato é simples: package.json diz o que você precisa, package-lock.json diz quais versões exatas você tinha, e node_modules é só o resultado desempacotado dos dois. Apague o node_modules, rode npm ci e em poucos minutos a árvore idêntica volta — não é truque de recuperação, é o fluxo previsto. O único erro imperdoável é apagar o lockfile ou deixar um projeto apodrecer sem um lockfile commitado. Para achar as pastas, npx npkill varre todos os seus discos, lista cada node_modules com tamanho e data e apaga os que você marcar; o WizTree faz o mesmo papel como mapa geral do disco se você quiser a visão completa.

• Apague node_modules — nunca package.json nem o lockfile
• Reinstale com npm ci: segue o lockfile à risca, ao contrário do npm install
• Rode npx npkill para achar e matar node_modules em todos os discos
• Mantenha projetos ativos fora das pastas do OneDrive e do Dropbox — o volume de arquivos mata a sincronização
• Projeto morto? Compacte em zip sem o node_modules e apague a pasta
• Em projetos novos, experimente o pnpm: um depósito global em que os projetos linkam

Os caches por trás da pasta

Mesmo com todos os node_modules mortos, o npm mantém um segundo estoque: o cache em %LOCALAPPDATA%\npm-cache com uma cópia de cada versão de cada pacote que você já instalou — gigas que crescem sem parar por anos. npm cache verify limpa com segurança, e a mesma lógica vale para pnpm store prune e yarn cache clean nos respectivos depósitos. Desativar o cache do npm seria um erro: é ele que faz a reinstalação de um projeto com o cache vazio ser o caminho lento, e não a norma. Uma varredura periódica com o Kleaner PRO pega esses caches de desenvolvedor junto com os temporários de sempre — útil quando várias ferramentas acumularam em silêncio na mesma máquina.

Perguntas e respostas

Continue lendo