Aller au contenu principal

.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.

GitQuest
Démo

Par Anaïs Sparesotto, développeuse web et responsable pédagogique · Mis à jour le

Les bases

À 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)

.env

Clés API, secrets, identifiants de base de données

dist/ / build/

Sortie compilée (régénérée au build)

.DS_Store

Fichiers système macOS sans valeur pour le projet

Syntaxe

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 placeholder

En 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
Astuce avancée

.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

A

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é.