Todo projeto Node.js precisa de um arquivo .gitignore. Sem ele, você vai acabar commitando node_modules (milhares de arquivos), variáveis de ambiente com chaves de API, artefatos de build, e arquivos de configuração de editor que não pertencem ao controle de versão.
Este template usa as regras oficiais do GitHub para gitignore de Node.js e adiciona regras comumente necessárias para VS Code, macOS, Windows e Linux. Ele cobre fluxos de trabalho npm, yarn e pnpm prontos para usar.
Como usar
1. Revise os templates pré-selecionados abaixo (Node.js + VS Code + arquivos de SO)
2. Adicione ou remova templates para combinar com seu projeto
3. Clique em "Copiar" ou "Baixar" para obter o arquivo
4. Coloque-o no diretório raiz do seu projeto antes do primeiro commit
Perguntas frequentes
Devo commitar node_modules?
Não. O diretório node_modules pode conter centenas de megabytes de arquivos e milhares de pacotes. Deve sempre estar no .gitignore. Use 'npm install' ou 'yarn install' para recriá-lo a partir de package.json e do lock file.
Devo commitar package-lock.json ou yarn.lock?
Sim. Lock files garantem que todos no seu time recebam exatamente as mesmas versões de dependências. Sempre commite seu lock file (package-lock.json, yarn.lock ou pnpm-lock.yaml) mas não o próprio node_modules.
Devo ignorar arquivos .env?
Sim. Arquivos de ambiente (.env, .env.local) frequentemente contêm chaves de API, credenciais de banco de dados e outros segredos. Adicione .env* ao seu .gitignore. Use .env.example (commitado) para documentar quais variáveis são necessárias.