Un file .gitignore pronto in pochi clic
Il file .gitignore, messo nella cartella principale di un repository di codice, elenca ciò che il controllo di versione deve tralasciare: dipendenze scaricate, file compilati, log, le password del file .env e i file nascosti creati dal sistema operativo o dall'editor. Questo generatore gitignore compone il file per te a partire da 49 modelli, senza righe doppie.
Non viene inviato nulla: il file viene composto nel tuo browser. La selezione e le righe personali restano salvate su questo dispositivo per la prossima volta.
Come si usa
- In «Cerca un modello» scrivi una parola come
python,cmakeologper filtrare l'elenco. - Seleziona i modelli che ti servono. Sono divisi in quattro gruppi: «Linguaggi», «Framework e strumenti di build», «Ambienti, segreti e file generati» e «File di sistema e degli editor». «Deseleziona tutto» ricomincia da zero.
- Il risultato compare subito in «File .gitignore», con il numero di modelli, di regole e di doppioni rimossi.
- Aggiungi i tuoi percorsi in «Righe personali (aggiunte in fondo)», uno per riga, per esempio
uploads/. - Togli la spunta a «Sezioni commentate» se vuoi un file senza i titoli
# …. - Clicca su «Scarica .gitignore» oppure su «Copia».
Alcuni browser tolgono il punto iniziale dal nome di un file scaricato. Se ricevi un file chiamato gitignore, rinominalo in .gitignore e mettilo nella cartella principale del progetto.
Esempio: un progetto in C e C++ con CMake
Seleziona «C», «C++» e «CMake». Il modello C++ ripete dodici righe del modello C, come *.o, *.so e *.exe: lo strumento le scrive una sola volta e mostra «Modelli: 3 · regole: 24 · doppioni rimossi: 12». Nella sezione C++ restano solo *.ilk e *.pdb, mentre CMake aggiunge CMakeCache.txt, CMakeFiles/, build/ e gli altri file prodotti dalla configurazione.
Per un sito in PHP, «PHP», «Laravel», «Segreti e .env» e «Cartelle di IDE ed editor (.idea, .vscode)» coprono l'essenziale. Aggiungi «Metadati delle cartelle (.DS_Store…)» e «Miniature e impostazioni cartella (Thumbs.db…)» se nel gruppo di lavoro si usano sistemi operativi diversi.
Le regole da conoscere
| Riga | Effetto |
|---|---|
*.log | tutti i file che finiscono in .log, in tutto il progetto |
logs/ | qualsiasi cartella chiamata logs, con il suo contenuto |
/vendor/ | la cartella vendor solo nella radice |
!.env.example | eccezione: questo file resta tracciato nonostante .env.* |
**/*.rs.bk | questi file in qualsiasi sottocartella |
L'ordine conta: un'eccezione che inizia con ! deve venire dopo la regola che corregge. Il generatore mantiene l'ordine dei modelli e mette le tue righe personali per ultime, così hanno l'ultima parola. Una riga che inizia con # è un commento.
Il .gitignore non è l'unico file nascosto utile nella radice di un sito: per redirect e cache lato server c'è il generatore htaccess, e per guidare i crawler dei motori di ricerca il generatore di robots.txt. Se il progetto usa file di configurazione in YAML, puoi validare YAML prima di pubblicarli.
Domande frequenti
Ho aggiunto una regola ma il file è ancora tracciato. Perché?
Il .gitignore vale solo per i file non ancora tracciati. Per un file già registrato nel repository, toglilo dall'indice con git rm --cached percorso/del/file (resta sul tuo disco) e conferma la modifica.
Bisogna ignorare il file di lock delle dipendenze?
Di solito no. File come composer.lock o package-lock.json fissano le versioni esatte: in un'applicazione tienili nel repository. Nessun modello li ignora; solo quello di Dart ignora pubspec.lock, come si usa per una libreria.
Le mie password sono già state pubblicate. Basta il .gitignore?
No. Ignorare il file .env evita fughe future, ma la cronologia conserva la vecchia versione. Cambia subito le password e le chiavi coinvolte.
Posso avere più file .gitignore?
Sì. Ogni cartella può avere il suo, e le sue regole valgono per quella cartella e per tutte le sottocartelle. Un solo file nella radice resta comunque il più facile da rileggere.