Het bestand .gitignore begrijpen

Bouwartefacten, logboeken, geheimen en mappen met afhankelijkheden mogen nooit worden vastgelegd. Het bestand .gitignore vertelt Git precies welke bestanden moeten worden overgeslagen.

Een .gitignore is gewoon een tekstbestand vol patronen. Elk pad dat met een patroon overeenkomt, wordt buiten het klaarzetgebied en commits gehouden, zodat je opslagplaats schoon blijft.

Plaats een .gitignore in de hoofdmap van je opslagplaats, met één patroon per regel. Het onderstaande voorbeeld negeert afhankelijkheden, logboeken en je omgevingsbestand.

De basispatronen: *.log komt overeen op basis van de extensie, build/ komt overeen met een hele map en een gewone naam met één exact bestand.

Een voorloopslash verankert een patroon in de hoofdmap van de opslagplaats. Zo negeert /todo.txt alleen het bestand op het hoogste niveau, niet een bestand met dezelfde naam dieper in de mappenstructuur.

Voorzie een patroon van ! om iets dat door een eerdere regel was uitgesloten weer toe te staan, bijvoorbeeld alle logboeken negeren behalve één bestand dat je wilt behouden.

Voor jokertekens geldt: één * komt overeen met alles behalve een slash, terwijl ** overeenkomt met mappen op elke diepte.

Regels die beginnen met # zijn opmerkingen en lege regels worden overgeslagen. Gebruik beide om je .gitignore overzichtelijk en leesbaar te houden.

Een belangrijke valkuil: .gitignore heeft alleen effect op niet-bijgehouden bestanden. Als een bestand al wordt bijgehouden, doet de regel niets totdat je het uit de opslagplaats verwijdert met git rm --cached.

Weet je niet waarom een pad wordt genegeerd? git check-ignore -v vertelt je precies welke regel en welke regelpositie ermee overeenkwamen.

Voor persoonlijke rommel, zoals editorinstellingen en rommel van het besturingssysteem, die nooit in een opslagplaats terecht mag komen, stel je een globale negeerregel in in plaats van projectbestanden te vervuilen.

Je beheerst nu .gitignore: patronen, jokertekens (*, **), verankering (/) en negatie (!). Onthoud dat het alleen invloed heeft op niet-bijgehouden bestanden — gebruik git check-ignore om problemen op te sporen.