O que é node_modules no Mac e é seguro apagar?

Onde fica

O que é

Quando você executa npm install, yarn ou pnpm install em um projeto JavaScript ou TypeScript, o gerenciador de pacotes lê o package.json e coloca cada dependência, e cada dependência dessas dependências, em uma pasta node_modules dentro do projeto.

Ela fica grande porque projetos modernos puxam centenas ou milhares de pacotes, alguns com binários compilados. Cada projeto tem sua própria cópia, então dez projetos significam dez pastas node_modules, incluindo projetos que você não abre há anos.

Nada do que você escreveu fica em node_modules. O que importa são o seu código, o package.json e o lockfile, e eles bastam para recriá-la.

Que tamanho pode atingir

Normalmente centenas de MB por projeto, e mais de um GB em apps maiores e monorepos.

Como limpar manualmente

1. Pare qualquer servidor de desenvolvimento ou compilação que esteja rodando no projeto.
2. Abra o Terminal e entre na pasta do projeto.
3. Execute o comando abaixo. Ele apaga a pasta node_modules apenas da pasta atual, então confira antes onde você está com pwd.
4. Quando for trabalhar no projeto de novo, execute npm install, yarn install ou pnpm install para restaurá-la.

rm -rf node_modules

O que acontece depois

O projeto não vai rodar nem compilar até você instalar as dependências de novo. Com um lockfile presente você recebe as mesmas versões de volta, e a reinstalação é mais rápida se o cache do gerenciador de pacotes ainda estiver no disco.

Como o Diskzy lida com isso

O Diskzy encontra pastas de compilação de projetos, como node_modules, na aba Clean up (Limpeza). A pasta fica desmarcada se o projeto foi alterado nos últimos 14 dias.

Guias relacionados

• npm cache~/.npm/_cacache
• pnpm store~/Library/pnpm/store
• Yarn cache~/Library/Caches/Yarn