Pourquoi mon .gitignore ne fonctionne pas ?

La raison la plus courante est que les fichiers etaient deja suivis par Git avant d'etre ajoutes au .gitignore. Il faut les retirer de l'index avec git rm --cached , puis commiter. Apres ca, .gitignore empechera qu'ils soient suivis a nouveau.

Ou placer le fichier .gitignore ?

Place le .gitignore a la racine de ton depot. Tu peux aussi avoir des fichiers .gitignore dans des sous-repertoires pour ajouter des regles specifiques a ce dossier. Les regles d'un .gitignore de sous-dossier ne s'appliquent qu'aux fichiers de ce repertoire et ses enfants.

Comment ignorer un dossier mais garder un fichier dedans ?

Utilise le pattern de negation avec !. D'abord ignore le dossier (logs/), puis nie le fichier specifique (!logs/.gitkeep). L'ordre compte : la negation doit venir apres la regle d'exclusion.

C'est quoi un .gitignore global ?

Un .gitignore global s'applique a tous les depots Git de ta machine. Configure-le avec git config --global core.excludesfile ~/.gitignore_global. C'est ideal pour les fichiers OS (.DS_Store, Thumbs.db) et les configs d'editeur (.vscode/, .idea/) qui sont personnels et pas specifiques au projet.

Faut-il commiter le fichier .gitignore ?

Oui, commite toujours le .gitignore dans ton depot. Ca garantit que tous les contributeurs partagent les memes regles d'exclusion. La seule exception concerne les patterns d'editeur ou d'OS personnels, qui appartiennent a ton gitignore global.

.gitignore : comment bien l'ecrire

Le fichier .gitignore indique a Git quels fichiers ignorer. Apprends les regles de syntaxe, decouvre les modeles pour les langages populaires et corrige les erreurs courantes.

Pratiquer les bases Git Glossaire Git

gitquest — enquête

Les bases

A quoi sert .gitignore et pourquoi c'est important

Un fichier .gitignore indique a Git quels fichiers et repertoires exclure du suivi de version. Il se place a la racine de ton depot et applique ses regles a tout ce qui se trouve en dessous.

Sans .gitignore, Git suivrait tout : dependances, artefacts de build, secrets d'environnement, fichiers du systeme. Ca alourdit ton depot, ralentit les clones, et peut exposer des donnees sensibles comme des cles API.

Chaque projet devrait avoir un fichier .gitignore des le premier commit. C'est l'une des premieres choses a configurer apres git init.

Fichiers a toujours ignorer

node_modules/

Dependances (reinstallees via npm install)

.env

Cles API, secrets, identifiants de base de donnees

dist/ / build/

Sortie compilee (regeneree au build)

.DS_Store

Fichiers systeme macOS sans valeur pour le projet

Syntaxe

Les regles de syntaxe .gitignore

Le fichier .gitignore utilise un systeme de patterns simple. Voici les regles a connaitre.

`#` Commentaires

Les lignes qui commencent par # sont des commentaires. Utilise-les pour documenter pourquoi une regle existe.

# Ignorer la sortie de build

`*` Joker (wildcard)

Correspond a n'importe quel nombre de caracteres (sauf /). Utilise ** pour correspondre a travers les repertoires.

*.log         # Tous les fichiers .log
**/*.tmp      # Tous les .tmp dans n'importe quel sous-dossier

`/` Separateur de repertoire

Un slash final signifie "repertoires uniquement". Un slash initial ancre le pattern a la racine du depot.

build/        # Ignore tout repertoire nomme build
/build/       # Ignore build/ uniquement a la racine du depot

`!` Negation

Prefixe avec ! pour re-inclure un fichier precedemment ignore. L'ordre compte.

logs/         # Ignore le dossier logs
!logs/.gitkeep # Mais garde ce fichier placeholder

En pratique dans le terminal

Creer un .gitignore et corriger les fichiers deja suivis.

Creer un .gitignore

gitquest — .gitignore

# Creer un fichier .gitignore dans ton projet

$touch .gitignore

# Ajouter des patterns courants

$echo "node_modules/" >> .gitignore

$echo ".env" >> .gitignore

$echo "dist/" >> .gitignore

$cat .gitignore

node_modules/

.env

dist/

$git add .gitignore

$git commit -m "Ajout du .gitignore"

[main a1b2c3d] Ajout du .gitignore

Corriger les fichiers deja suivis

gitquest — rm --cached

# Oups ! node_modules etait deja suivi

$git rm -r --cached node_modules/

rm 'node_modules/express/index.js'

rm 'node_modules/express/package.json'

... (des centaines de fichiers)

Fichiers retires du suivi (toujours sur le disque)

$git commit -m "Arreter le suivi de node_modules"

[main f4e5d6c] Arreter le suivi de node_modules

# Maintenant .gitignore empechera de les re-ajouter

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

.gitignore global pour ta machine

Certains fichiers sont personnels a ton environnement et ne devraient jamais etre commites dans aucun projet. Configure un .gitignore global pour les gerer une fois pour tous tes depots.

gitquest — gitignore global

# Configurer un .gitignore global pour tous les depots

$git config --global core.excludesfile ~/.gitignore_global

# Ajouter les fichiers OS et editeur a ne jamais suivre

$echo ".DS_Store" >> ~/.gitignore_global

$echo "Thumbs.db" >> ~/.gitignore_global

$echo ".vscode/" >> ~/.gitignore_global

$echo "*.swp" >> ~/.gitignore_global

Gitignore global configure !

Ce qui va dans le global

Fichiers OS (.DS_Store, Thumbs.db), configs d'editeur (.vscode/, .idea/, *.swp), et tout fichier d'outil personnel qui n'est pas specifique a un projet.

Ce qui va dans le .gitignore du projet

Dependances (node_modules/, .venv/), sortie de build (dist/, target/), fichiers d'environnement (.env), et tout ce qui est specifique a 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

Pret a bien configurer ton projet Git ?

GitQuest t'apprend les fondamentaux de Git pas a pas avec des exercices interactifs dans un terminal securise.

Commencer a apprendre Git