Ce que fait l’outil
Le générateur de .gitignore crée le fichier .gitignore de votre dépôt en combinant des modèles prêts à l’emploi. Choisissez les langages, frameworks, outils de build, moteurs de jeu, éditeurs et systèmes d’exploitation de votre projet : l’outil fusionne leurs règles dans un seul fichier, avec un titre ### Nom ### par section, prêt à copier ou à télécharger.
Une soixantaine de modèles de la collection github/gitignore sont inclus : Node.js, Python, Java, Go, Rust, .NET, Swift, des frameworks PHP comme Laravel et Symfony, Next.js, Flutter, Android, Terraform, Unity, Unreal Engine, Godot, VS Code, les IDE JetBrains, Vim, Emacs, macOS, Windows, Linux et d’autres. Tout s’exécute dans votre navigateur ; aucune requête n’est envoyée.
Mode d’emploi
- Cliquez sur les modèles de la liste pour les ajouter. La recherche reconnaît aussi les alias courants : « typescript » trouve Node.js et « intellij » trouve JetBrains.
- Les modèles choisis s’affichent en haut sous forme d’étiquettes, dans l’ordre de sélection, et le fichier suit cet ordre. Cliquez sur une étiquette pour la retirer, ou sur Effacer pour recommencer.
- Ajoutez les entrées propres au projet dans Règles personnalisées, séparées par des virgules, par exemple
.env, /dist, *.local. Elles sont ajoutées à la fin dans une section### Custom ###. - Choisissez de garder ou non les commentaires explicatifs des modèles, et de supprimer ou non les règles déjà listées par un modèle précédent.
- Copiez le résultat ou téléchargez-le. Le fichier téléchargé s’appelle
.gitignore; enregistrez-le à la racine du dépôt.
La sélection est enregistrée dans l’adresse de la page : un favori ou un lien partagé reproduit le même fichier.
Exemple
En choisissant Node.js, macOS et VS Code avec la règle personnalisée .env.local et les commentaires désactivés, on obtient un fichier comme celui-ci (abrégé) :
### Node.js ###
logs
*.log
npm-debug.log*
…
node_modules/
…
### macOS ###
.DS_Store
.AppleDouble
.LSOverride
…
### VS Code ###
.vscode/*
!.vscode/settings.json
!.vscode/tasks.json
!.vscode/launch.json
!.vscode/extensions.json
!.vscode/*.code-snippets
!*.code-workspace
*.vsix
### Custom ###
.env.local
Les motifs qui commencent par ! réincluent ce qu’une règle précédente a exclu : ici, les paramètres, tâches et configurations de lancement partagés de VS Code restent dans le dépôt tandis que l’état personnel de l’éditeur est ignoré. Ajouter .env en règle personnalisée ne changerait rien, car le modèle Node.js le contient déjà.
Conseils
- Placez les règles de vos outils personnels (fichiers d’échange de l’éditeur, métadonnées du système) dans un fichier d’exclusion global : tous vos dépôts en profitent sans les répéter.
- Une barre oblique finale comme
build/ne correspond qu’aux dossiers ; une barre initiale comme/buildancre la règle à la racine du dépôt. - Utilisez
git check-ignore -v <chemin>pour voir quelle ligne de quel fichier d’exclusion correspond à un chemin. - Ne comptez pas sur .gitignore pour protéger des secrets déjà commités : changez-les et réécrivez l’historique.
FAQ
› D’où viennent les modèles ?
Ce sont des copies intégrées de la collection officielle github/gitignore, publiée par GitHub sous la dédicace au domaine public CC0. Rien n’est téléchargé quand vous utilisez l’outil : les modèles sont livrés avec la page.
› Pourquoi un fichier est-il encore suivi après l’avoir ajouté à .gitignore ?
.gitignore ne concerne que les fichiers non suivis. Si le fichier a déjà été commité, retirez-le de l’index avec git rm --cached <fichier> (ou -r pour un dossier) puis commitez ; le fichier reste sur le disque et sera ignoré ensuite.
› À quoi sert Supprimer les règles en double ?
Beaucoup de modèles partagent des règles : Java et Kotlin ignorent *.class, C et C++ ignorent *.o. Avec l’option activée, chaque règle n’est écrite qu’à sa première apparition, et un commentaire de titre dont toutes les règles ont été retirées disparaît aussi. Désactivez-la pour obtenir chaque modèle tel qu’il est publié.
› Faut-il commiter le fichier .gitignore ?
Oui. Un .gitignore commité s’applique à tous ceux qui clonent le dépôt. Les règles propres à votre machine, comme votre éditeur ou votre système, peuvent aussi aller dans un fichier d’exclusion global (git config --global core.excludesFile ~/.gitignore_global).