.gitignore : comment bien l'écrire
Le fichier .gitignore indique à Git quels fichiers ignorer. Apprends les règles de syntaxe, découvre les modèles pour les langages populaires et corrige les erreurs courantes.
Par Anaïs Sparesotto, développeuse web et responsable pédagogique · Mis à jour le
À quoi sert .gitignore et pourquoi c'est important
Un fichier .gitignore indique à Git quels fichiers et répertoires exclure du suivi de version. Il se place à la racine de ton dépôt et applique ses règles à tout ce qui se trouve en dessous.
Sans .gitignore, Git suivrait tout : dépendances, artefacts de build, secrets d'environnement, fichiers du système. Ça alourdit ton dépôt, ralentit les clones, et peut exposer des données sensibles comme des clés API.
Chaque projet devrait avoir un fichier .gitignore dès le premier commit. C'est l'une des premières choses à configurer après git init.
Fichiers à toujours ignorer
node_modules/Dépendances (réinstallées via npm install)
.envClés API, secrets, identifiants de base de données
dist/ / build/Sortie compilée (régénérée au build)
.DS_StoreFichiers système macOS sans valeur pour le projet
Les règles de syntaxe .gitignore
Le fichier .gitignore utilise un système de patterns simple. Voici les règles à connaître.
# Commentaires
Les lignes qui commencent par # sont des commentaires. Utilise-les pour documenter pourquoi une règle existe.
# Ignorer la sortie de build* Joker (wildcard)
Correspond à n'importe quel nombre de caractères (sauf /). Utilise ** pour correspondre à travers les répertoires.
*.log # Tous les fichiers .log
**/*.tmp # Tous les .tmp dans n'importe quel sous-dossier/ Séparateur de répertoire
Un slash final signifie "répertoires uniquement". Un slash initial ancre le pattern à la racine du dépôt.
build/ # Ignore tout repertoire nomme build
/build/ # Ignore build/ uniquement a la racine du depot! Négation
Préfixe avec ! pour re-inclure un fichier précédemment ignoré. L'ordre compte.
logs/ # Ignore le dossier logs
!logs/.gitkeep # Mais garde ce fichier placeholderEn pratique dans le terminal
Créer un .gitignore et corriger les fichiers déjà suivis.
Créer un .gitignore
Corriger les fichiers déjà suivis
Modèles .gitignore courants
Node.js
node_modules/
dist/
.env
.env.local
npm-debug.log*
.next/Python
__pycache__/
*.py[cod]
.venv/
.env
*.egg-info/
dist/Java
*.class
target/
.gradle/
build/
.idea/
*.jar.gitignore global pour ta machine
Certains fichiers sont personnels à ton environnement et ne devraient jamais être commités dans aucun projet. Configure un .gitignore global pour les gérer une fois pour tous tes dépôts.
Ce qui va dans le global
Fichiers OS (.DS_Store, Thumbs.db), configs d'éditeur (.vscode/, .idea/, *.swp), et tout fichier d'outil personnel qui n'est pas spécifique à un projet.
Ce qui va dans le .gitignore du projet
Dépendances (node_modules/, .venv/), sortie de build (dist/, target/), fichiers d'environnement (.env), et tout ce qui est spécifique à la stack technique du projet.
Fait partie du guide Les bases de Git
GitQuest est conçu par Anaïs (nouvelle fenêtre), développeuse web et responsable pédagogique, spécialisée en formations tech et accessibilité numérique.
Questions sur .gitignore
Prêt à bien configurer ton projet Git ?
GitQuest t'apprend les fondamentaux de Git pas à pas avec des exercices interactifs dans un terminal sécurisé.