Introduction
En développement logiciel, le dossier de votre projet peut rapidement se remplir de fichiers qui ne doivent pas être partagés. Il peut notamment s’agir des éléments suivants :
- Fichiers temporaires : générés par votre éditeur ou votre système d’exploitation (par exemple,
.DS_Store). - Artefacts de compilation : code compilé (par exemple,
.exe,.class). - Journaux : fichiers qui enregistrent l’exécution d’un programme (par exemple,
debug.log). - Secrets : clés API ou mots de passe (ne les validez JAMAIS dans Git !).
Git propose une fonctionnalité appelée .gitignore. Il s’agit d’une simple liste de règles indiquant les fichiers à ne pas suivre. Lorsqu’un fichier correspond à l’une de ces règles, Git le laisse par défaut à l’état non suivi.
Ce mécanisme définit une règle pour l’arborescence de travail. Il indique à Git quels fichiers non suivis doivent être considérés comme du bruit normal en arrière-plan plutôt que comme des fichiers source potentiels à ajouter.
Il ne s’agit pas seulement de garder un dossier bien rangé. Un bon fichier .gitignore aide à éviter le bruit, les dépôts trop volumineux et la validation accidentelle de secrets ou de fichiers inutiles propres à une machine.
Dans ce lab, vous allez :
- Créer un fichier « inutile » que vous souhaitez ignorer.
- Configurer un fichier
.gitignore. - Vérifier que Git ignore bien ce fichier inutile.
Créer un fichier journal
Commencez par créer un fichier qui représente des données « inutiles ». Imaginez que votre application génère un fichier journal à chaque exécution. Vous souhaitez conserver ce fichier sur votre machine locale pour le débogage, mais vous ne voulez ni le partager avec l’équipe ni l’enregistrer dans l’historique.
Accédez au répertoire du projet :
cd ~/project
Créez un fichier nommé debug.log contenant un texte fictif :
echo "System started at $(date)" > debug.log
Vérifiez qu’il existe :
ls
À ce stade, si vous exécutez git status, Git verra ce fichier comme « Untracked » et vous demandera sans cesse de l’ajouter.
C’est le comportement normal pour un fichier que Git a détecté, mais qui n’est pas encore ignoré. Git vous demande en quelque sorte si ce fichier doit faire partie du dépôt.
Créer le fichier .gitignore
Pour demander à Git de ne plus signaler certains fichiers, vous avez besoin d’un fichier de configuration spécial nommé .gitignore.
Créez ce fichier à la racine de votre projet :
touch .gitignore
Vérifiez qu’il a bien été créé (rappelez-vous qu’il est masqué parce que son nom commence par un point) :
ls -a
Le fichier .gitignore est un simple fichier texte. En général, vous devez valider le fichier .gitignore lui-même dans Git, afin que tous les membres de votre équipe utilisent les mêmes règles d’exclusion.
Cette distinction est importante : les fichiers ignorés sont généralement des artefacts locaux, tandis que .gitignore constitue généralement une configuration du projet et doit être placé sous contrôle de version.
Configurer les règles d’exclusion
Ajoutez maintenant une règle pour ignorer tous les fichiers journaux.
Vous pouvez utiliser le caractère générique * pour indiquer « tout ce qui se termine par .log ».
Ajoutez le motif *.log à votre fichier .gitignore :
echo "*.log" > .gitignore
Vérifiez le contenu du fichier :
cat .gitignore
Sortie :
*.log
Cette seule ligne indique à Git : « Ignorez tout fichier de ce répertoire, ainsi que de ses sous-répertoires, dont le nom se termine par .log ».
Les règles d’exclusion reposent sur des motifs ; elles ne s’appliquent pas à un seul fichier précis. C’est pourquoi un fichier .gitignore court peut gérer de nombreuses catégories de fichiers générés ou indésirables.
Vérifier l’état d’exclusion
Vérifiez maintenant que la règle fonctionne.
Exécutez git status :
git status
Analysez la sortie :
On branch master
No commits yet
Untracked files:
(use "git add <file>..." to include in what will be committed)
.gitignore
Attendez ! Où est passé debug.log ?
Il a disparu de la liste ! Cela signifie que Git l’ignore bien. Git vous signale uniquement .gitignore lui-même, que vous devriez finalement valider dans le dépôt ; debug.log, lui, est invisible pour Git.
C’est la différence concrète entre un fichier non suivi et un fichier ignoré. Les fichiers non suivis sont toujours proposés à l’ajout, tandis que les fichiers ignorés sont volontairement exclus de cette liste.
Pour vérifier de manière certaine, vous pouvez utiliser la commande check-ignore et demander : « Pourquoi ce fichier est-il ignoré ? »
git check-ignore -v debug.log
Sortie :
.gitignore:1:*.log debug.log
Cela signifie : « Le fichier debug.log est ignoré à cause de la règle *.log, située à la ligne 1 de .gitignore. »
Résumé
Dans ce lab, vous avez appris à garder votre dépôt propre.
Points essentiels :
.gitignore: fichier texte qui contient les motifs des fichiers que Git doit ignorer.- Caractères génériques : utilisez
*pour faire correspondre plusieurs fichiers (par exemple,*.log). - Non suivi ou ignoré : pour Git, un fichier ignoré est traité comme s’il n’existait pas, même s’il existe toujours sur votre disque.
Ce fichier simple est très puissant. Il vous empêche de valider accidentellement des fichiers temporaires, des fichiers binaires ou des clés sensibles, afin de garder votre projet professionnel et sécurisé.
