Guide du générateur .gitignore : créer rapidement des règles d'exclusion par type de projet

Qu'est-ce que .gitignore

Le fichier .gitignore indique à Git quels fichiers/répertoires ne doivent pas être versionnés :

node_modules/       ← Ignorer tout le répertoire
*.log               ← Ignorer tous les fichiers de log
.env                ← Ignorer le fichier de variables d'environnement
dist/               ← Ignorer la sortie de build

Les fichiers non suivis correspondant aux règles .gitignore sont automatiquement ignorés par Git. Les fichiers déjà suivis ne sont pas affectés.

Règles de syntaxe expliquées

Motifs de base

Syntaxe	Signification	Exemple
`*.ext`	Correspondre à tous les fichiers .ext	`*.log`
`dir/`	Correspondre à tout le répertoire	`node_modules/`
`file`	Correspondre à un fichier spécifique	`.env`
`**`	Correspondre à tout niveau de répertoire	`**/test`
`?`	Correspondre à un seul caractère	`config?.json`
`[abc]`	Correspondre à tout caractère entre crochets	`file[123].txt`

Motif de négation `!`

*.log           ← Ignorer tous les logs
!important.log  ← Mais conserver important.log

Les motifs de négation doivent être placés après la règle d'exclusion qu'ils annulent.

Règles de chemin

/README.md      ← Ignorer uniquement README.md à la racine
README.md       ← Ignorer README.md à tout niveau
docs/*.pdf      ← Ignorer les PDF dans docs/, non récursif
docs/**/*.pdf   ← Ignorer les PDF dans tous les sous-répertoires de docs/

Modèles courants de projets

Node.js

node_modules/
dist/
build/
.next/
.env
.env.local
*.log
coverage/

Python

__pycache__/
*.py[cod]
*.egg-info/
dist/
.venv/
venv/
.env
.pytest_cache/
.mypy_cache/

Java / Spring Boot

target/
*.class
*.jar
*.war
.gradle/
.idea/
*.iml
application-local.yml

IDE / Éditeurs

# VS Code
.vscode/

# IntelliJ IDEA
.idea/
*.iml

# macOS
.DS_Store

# Windows
Thumbs.db

Utilisation de l'outil gitignore

Étape 1 : Ouvrir l'outil

Visitez l'outil gitignore pour accéder à l'interface du générateur.

Étape 2 : Sélectionner le type de projet

Cochez les technologies utilisées dans votre projet :

☑ Node.js
☑ Python
☑ Java
☑ Vue / React / Angular

Étape 3 : Sélectionner l'IDE

Cochez les éditeurs utilisés par votre équipe :

☑ VS Code
☑ IntelliJ IDEA
☑ Autre

Étape 4 : Générer et télécharger

Cliquez sur « Générer ». L'outil fusionne automatiquement tous les modèles, supprime les doublons et produit un fichier .gitignore complet.

Étape 5 : Placer à la racine du projet

Placez le fichier téléchargé à la racine de votre dépôt Git. Assurez-vous que le nom du fichier est .gitignore (notez le point initial).

gitignore global

En plus du .gitignore au niveau du projet, vous pouvez définir des règles d'exclusion globales (s'applique à tous les dépôts) :

# Définir le fichier gitignore global
git config --global core.excludesFile ~/.gitignore_global

# Éditer les règles globales
vim ~/.gitignore_global

Exclusions globales recommandées :

# Fichiers système
.DS_Store
Thumbs.db

# Configurations IDE
.idea/
.vscode/

# Outils personnels
.todo

Les règles globales concernent les fichiers d'environnement personnel. Les règles au niveau du projet concernent les fichiers spécifiques au projet.

Gestion des fichiers déjà suivis

.gitignore n'affecte que les fichiers non suivis. Si un fichier est déjà suivi par Git :

# Cesser de suivre mais conserver le fichier local
git rm --cached .env

# Cesser de suivre un répertoire entier
git rm -r --cached node_modules/

# Commiter la modification de fin de suivi
git commit -m "chore: update gitignore and untrack files"

L'option --cached garantit la suppression uniquement de l'index Git, sans supprimer le fichier local.

Erreurs courantes

Erreur	Cause	Solution
Règle ne fonctionne pas	Fichier déjà suivi	Exécuter `git rm --cached` d'abord
Négation ne fonctionne pas	`!` placé avant la règle d'exclusion	Déplacer la règle `!` après la règle d'exclusion correspondante
Trop exclu	Motif trop large	Utiliser `/` pour limiter la portée du chemin
Oublié d'exclure .env	Modèle de variables d'environnement manquant	Toujours ajouter `.env` au .gitignore
Règles d'équipe incohérentes	Pas de modèle unifié	Utiliser l'outil pour générer un modèle standard

.gitignore et .gitkeep

Après avoir ignoré un répertoire, Git ne suit pas les répertoires vides. Pour préserver la structure des répertoires vides :

logs/           ← .gitignore ignore logs
logs/.gitkeep   ← .gitkeep comme espace réservé, préserve le répertoire

.gitkeep n'est pas une fonctionnalité Git — c'est une convention communautaire. Placez un fichier .gitkeep dans le répertoire vide.

Résumé

.gitignore est fondamental pour la configuration de projet. Des règles d'exclusion correctes empêchent la validation d'informations sensibles et de fichiers redondants. Maîtrisez la syntaxe, les modèles courants et la configuration globale, et utilisez l'outil gitignore pour une génération rapide — c'est la première étape vers un contrôle de version efficace.