.gitignore : fichier .gitignore

Le .gitignore liste des motifs de noms de fichiers ou de dossiers que Git doit systématiquement ignorer dans un dépôt : fichiers générés par la compilation, dépendances téléchargées (node_modules/, par exemple), fichiers de configuration locale à la machine du développeur, ou secrets qui ne doivent jamais être versionnés par accident.

Le fichier n’agit que sur des éléments non encore suivis par Git : un fichier déjà ajouté à l’index lors d’un commit précédent reste suivi indéfiniment malgré son ajout ultérieur au .gitignore, jusqu’à ce qu’il soit explicitement retiré du suivi avec la commande git rm --cached. C’est une confusion fréquente chez qui découvre l’outil, qui s’attend à tort à ce que l’ajout au .gitignore fasse disparaître un fichier déjà suivi.

Chaque ligne du fichier accepte des motifs génériques (astérisques pour tout caractère, double astérisque pour une profondeur de dossiers arbitraire) ainsi qu’une négation (préfixe !) pour réintroduire une exception à une règle plus générale par ailleurs, par exemple ignorer le contenu d’un dossier de build sauf un fichier précis qu’il contient. La règle doit alors viser le contenu (build/* puis !build/fichier) et non le dossier lui-même : avec build/, Git ignore le dossier entier sans l’explorer, et aucune négation ne peut plus réintroduire un fichier dont un dossier parent est exclu.

Un projet peut contenir plusieurs fichiers .gitignore simultanément : Git accepte un fichier à la racine du dépôt ainsi que dans n’importe quel sous-dossier, chacun s’appliquant à son propre dossier et aux sous-dossiers qu’il contient. Cette organisation est pratique pour des règles spécifiques à un module particulier sans surcharger le fichier racine de règles qui ne concernent qu’une petite partie de l’arborescence du projet.