Parfois un projet ne contient pas uniquement que du code écrit par son ou ses développeurs, mais aussi des fichiers ou dossiers générés par des outils, tels que: des éditeurs de textes, des compilateurs, etc. Ces fichiers, bien qu'utiles pour la personne les ayant générés, ne sont malheureusement pas utiles pour les autres membres de son équipe. Pire, ils peuvent ralentir Git et même créer des conflits inutiles à répétition. Afin d'éviter ces désagréments, il est nécessaire de pouvoir indiquer à Git de ne pas monitorer certains fichiers 📄 ou dossiers 📁.

Création

Lorsque vous créez un répertoire sur GitHub, celui-ci vous propose de créer un fichier .gitignore pour vous. Si vous avez sauté cette étape, il est possible de manuellement créer un fichier nommé .gitignore à la racine de votre projet.

Ignorer un fichier 📄

Pour ignorer un fichier par nom, il suffit d'inscrire le nom du fichier en question dans le fichier .gitignore.

Par exemple, pour ignorer le fichier "demo.txt":

demo.txt

Pour ignorer tous les fichiers avec une extension en particulier, il suffit de spécifier le nom de l'extension en question et de la préfixer par le symbole * indiquant que tout nom est accepté.

Par exemple, pour ignorer tous les fichiers ".txt":

*.txt

Ignorer un dossier 📁

Pour ignorer un dossier, il suffit de nommer le dossier en question dans le fichier .gitignore et de lui ajouter en suffixe le symbole / indiquant qu'il s'agit d'un dossier.

Par exemple pour ignorer le dossier "node_modules":

node_modules/

Commentaires

Tout texte préfixé par le symbole # est considéré comme étant commentaire à l'intérieur d'un fichier .gitignore. Il est de bonne coutume de spécifier avec un commentaire ce que fait une ligne dans un fichier .gitignore.

Par exemple:

# Ignore all NPM dependencies
node_modules/