.gitignore-generator

Selecteer alle technologieën die deze repository gebruikt.

Regels voor je besturingssysteem en editor horen meestal in je globale Git-bestand met uitsluitingen.

Volgende: regels controleren

Selecteer de technologieën die je repository gebruikt om een project-.gitignore te maken voor gegenereerde bestanden, afhankelijkheden en lokale omgevingsbestanden. Je kunt meerdere technologieën kiezen. Regels voor je besturingssysteem en editor verschijnen apart, zodat persoonlijke voorkeuren in je globale Git-bestand met uitsluitingen kunnen blijven.

Zo maak en gebruik je uitsluitingsregels

  1. 1

    Selecteer je projecttechnologieën

    Kies alles wat de repository gebruikt, bijvoorbeeld Laravel én Node.js voor een PHP-app met een frontendbuild.

  2. 2

    Voeg zo nodig persoonlijke regels toe

    Selecteer je besturingssysteem of editor om een aparte reeks globale uitsluitingen te zien. Sla dit over als je bestaande globale bestand ze al bevat.

  3. 3

    Controleer, kopieer of download

    Bekijk de projectregels. Kopieer ze naar een `.gitignore` in de hoofdmap van de repository of download de ZIP en pak de `.gitignore` daar uit. Zet eventuele persoonlijke regels in je globale Git-bestand met uitsluitingen.

  4. 4

    Controleer vóór de commit

    Commit de project-`.gitignore` zodat teamgenoten de regels ontvangen. Controleer of gewenste bestanden, vooral voorbeeldconfiguraties en lockbestanden, nog zichtbaar zijn voor Git.

Welke regels horen in welk bestand?

Soort regel Locatie Voorbeeld
Projectuitvoer en geïnstalleerde afhankelijkheden Een gecommitte .gitignore in de repository node_modules/, vendor/, __pycache__/
Lokale omgevingswaarden De project-.gitignore .env en lokale varianten van .env.*
Bestanden van je eigen besturingssysteem en editor Een globaal Git-bestand met uitsluitingen, of .git/info/exclude voor één repository Finder-metagegevens of editorback-ups
Bestanden die collega’s nodig hebben Waar nodig blijven volgen met Git .env.example, package-lock.json, composer.lock, Gemfile.lock

Git leest projectbestanden met de naam .gitignore, het repositoryspecifieke .git/info/exclude en je persoonlijke core.excludesFile. Als je .gitignore commit, gaan de projectregels mee met de repository. Een persoonlijke regel geldt normaal alleen op je eigen computer. Lees de Git-handleiding voor gitignore en de GitHub-handleiding voor het uitsluiten van bestanden.

Voorbeeld: een Node.js-service met Python-scripts

Selecteer Node.js en Python. Het projectbestand combineert regels voor geïnstalleerde pakketten zoals node_modules/, Node-builduitvoer zoals dist/ en door Python gegenereerde bestanden zoals __pycache__/ en .venv/. Het sluit ook lokale .env-waarden uit, terwijl .env.example gevolgd kan blijven. Gebruik je een Mac en Visual Studio Code, selecteer dan die persoonlijke opties om hun regels apart te bekijken. Vergelijk beide resultaten met je eigen repository voordat je ze opslaat.

De generator gebruikt de geselecteerde sjablonen; hij kan je bestanden niet bekijken en weet niet of een map met de naam dist/ gegenereerde uitvoer bevat of broncode die je wilt committen. Maak een regel specifieker of verwijder hem als die niet bij je project past. Met git check-ignore -v path/to/file zie je welke regel op een nog niet gevolgd bestand van toepassing is. De GitHub-verzameling met sjablonen is handig als referentie voor technologieën en editors, maar vervangt de controle van je eigen repository niet.

Omgevingsbestanden en lockbestanden

Door .env uit te sluiten, voorkom je makkelijker dat lokale inloggegevens in nieuwe commits belanden. Een geheim dat al gecommit is, verdwijnt daardoor niet. Staat het in de Git-geschiedenis, haal het dan uit de tracking, controleer waar kopieën terechtkwamen en vervang de betreffende inloggegevens. Volg een opgeschoonde .env.example alleen als die tijdelijke aanduidingen bevat en geen echte geheimen. Het gegenereerde bestand bevat al !.env.example, zodat de brede regel .env.* dit voorbeeld niet verbergt. Laat die uitzondering staan als je de regels bewerkt.

Bewaar bij applicaties de lockbestanden, zodat installaties dezelfde gekozen versies gebruiken. npm raadt aan package-lock.json te committen en Composer raadt aan composer.lock te committen. Voor bibliotheken kunnen andere afspraken gelden; volg hun bouw- en releasebeleid.

Veelgestelde vragen

Uitsluitingsregels gelden voor bestanden die Git nog niet volgt. Wil je een bestand niet meer volgen maar lokaal bewaren, voer dan git rm --cached path/to/file uit en commit die verwijdering. Bevatte het bestand inloggegevens, vervang die dan en controleer de repositorygeschiedenis en eventuele kopieën.

Bewaar doorgaans een opgeschoonde .env.example en lockbestanden van applicaties in Git. Het voorbeeld documenteert de benodigde omgevingsvariabelen; een lockbestand legt de versies vast voor teamgenoten en deployments. Controleer of het voorbeeld geen echte geheimen bevat.

Ja. Selecteer alle technologieën die dezelfde repository gebruikt. De generator combineert de gekozen projectregels in één .gitignore. Controleer of je project bepaalde paden anders gebruikt.

Zet persoonlijke regels voor meerdere repositories in een globaal Git-bestand met uitsluitingen. Als XDG_CONFIG_HOME niet is ingesteld, gebruikt Git standaard ~/.config/git/ignore. Met core.excludesFile kun je een ander pad instellen. Voor een privéregel die alleen in deze repository geldt, gebruik je .git/info/exclude. Voeg de aparte persoonlijke uitvoer alleen toe aan het gedeelde projectbestand als het team die regels wil.

Je gekozen technologieën en eventuele keuzes voor besturingssysteem of editor gaan naar de server om de regels samen te stellen. In het proces met meerdere stappen staan die keuzes ook in de pagina-URL. Zet geen geheimen in de URL. De tool maakt regels op basis van je keuzes; hij leest je repository niet en uploadt er geen bestanden uit.

Gerelateerde tools

Tool beschikbaar in andere talen