Ogni progetto Node.js ha bisogno di un file .gitignore. Senza, finirai per committare node_modules (migliaia di file), variabili d'ambiente con chiavi API, artefatti di build e file di configurazione dell'editor che non appartengono al controllo di versione.
Questo template usa le regole gitignore ufficiali GitHub per Node.js e aggiunge regole comunemente necessarie per VS Code, macOS, Windows e Linux. Copre npm, yarn e pnpm out of the box.
Come usare
1. Rivedi i template preselezionati qui sotto (Node.js + VS Code + file OS)
2. Aggiungi o rimuovi template per adattarli al tuo progetto
3. Clicca "Copia" o "Download" per ottenere il file
4. Posizionalo nella directory root del progetto prima del primo commit
Domande frequenti
Devo committare node_modules?
No. La directory node_modules puรฒ contenere centinaia di megabyte di file e migliaia di pacchetti. Deve sempre essere nel .gitignore. Usa 'npm install' o 'yarn install' per ricrearla da package.json e dal lock file.
Devo committare package-lock.json o yarn.lock?
Sรฌ. I lock file assicurano che tutti nel team ottengano esattamente le stesse versioni delle dipendenze. Committa sempre il tuo lock file (package-lock.json, yarn.lock o pnpm-lock.yaml) ma non node_modules.
Devo ignorare i file .env?
Sรฌ. I file di ambiente (.env, .env.local) spesso contengono chiavi API, credenziali database e altri segreti. Aggiungi .env* al tuo .gitignore. Usa .env.example (committato) per documentare quali variabili sono necessarie.
Cosa includere nel .gitignore per npm?
Per npm: node_modules/, npm-debug.log*, .npm/, e le directory di build come dist/ o build/. Il package-lock.json invece va committato perchรฉ garantisce build riproducibili.
Devo ignorare la cartella .vscode?
Dipende. Alcuni file come settings.json e extensions.json possono essere utili da condividere con il team. Altri come launch.json contengono path locali. Un approccio comune รจ ignorare .vscode/* ma forzare l'inclusione di file specifici con !.vscode/extensions.json.
Come gestire i file di build in un progetto Node.js?
Ignora sempre le directory di output come dist/, build/, out/, .next/. Questi artefatti possono essere rigenerati dal codice sorgente e non devono essere nel controllo di versione.