Avant de créer votre premier commit, il reste un petit réglage à faire. Si vous sautez cette étape, Git risque de refuser de créer le commit, ou pire, de l'associer à un nom générique comme celui de la machine sur laquelle vous travaillez. Ce chapitre est court, mais il évite un vrai désagrément par la suite.

Pourquoi Git demande une identité

Chaque commit que vous créerez plus tard contiendra, en plus du changement lui-même, le nom et l'adresse e-mail de la personne qui l'a créé. C'est ce qui permet, sur un projet avec plusieurs contributeurs, de savoir qui a fait quoi. Sur un projet personnel, l'utilité semble moins évidente, mais l'information reste enregistrée dans l'historique dès le premier commit : autant qu'elle soit correcte dès le départ.

Attention à un point important, qui provoque une vraie confusion chez les débutants : cette identité n'a rien à voir avec un compte GitHub. Vous pouvez configurer un nom et un e-mail dans Git sans jamais posséder de compte GitHub, et inversement, un compte GitHub existant ne configure rien automatiquement dans Git sur votre ordinateur. Ce sont deux systèmes séparés, comme vu dans le premier guide de ce parcours.

Définir votre nom et votre e-mail

Ouvrez un terminal, peu importe le dossier dans lequel vous vous trouvez pour cette étape : le réglage que vous allez faire s'appliquera à tous vos futurs projets sur cet ordinateur. Tapez les deux commandes suivantes, en remplaçant les valeurs d'exemple par les vôtres.

Le mot --global signifie que ce réglage s'applique par défaut à tous les dépôts Git de votre ordinateur, pas uniquement au projet en cours. Vous pourrez plus tard, si besoin, définir une identité différente pour un dépôt précis en tapant la même commande sans --global depuis ce dépôt : Git utilisera alors ce réglage local à la place du réglage global, uniquement pour ce projet.

L'adresse e-mail n'a pas besoin d'être une adresse professionnelle ou même une adresse que vous consultez souvent. Elle sert d'identifiant dans l'historique. Si vous prévoyez de relier ce projet à GitHub plus tard, une bonne pratique consiste à utiliser la même adresse que celle de votre compte GitHub : cela permettra à GitHub d'associer automatiquement vos commits à votre profil, avec votre photo et votre nom d'utilisateur affichés dans l'historique en ligne. Ce n'est cependant pas obligatoire pour suivre ce parcours.

Vérifier ce qui a été enregistré

Une commande permet de relire l'ensemble des réglages globaux que vous venez de définir, sans en modifier aucun.

Si les deux lignes que vous venez de définir apparaissent, l'identité est en place. Vous pouvez aussi interroger un seul réglage à la fois, ce qui est utile pour vérifier rapidement sans faire défiler toute la liste.

Ce que Git affiche si vous oubliez cette étape

Si vous essayez de créer un commit sans avoir configuré votre nom et votre e-mail, Git refuse et affiche un message d'erreur assez explicite, qui vous rappelle exactement les deux commandes à taper. Ce n'est pas un blocage grave : lisez le message, tapez les deux lignes de configuration, puis retentez le commit. Rien n'est perdu entre-temps.

Bon réflexe

Faites cette configuration une bonne fois, dès l'installation de Git sur un nouvel ordinateur. Vous n'aurez plus besoin d'y repenser avant longtemps, sauf si vous changez d'adresse e-mail ou si vous travaillez sur un ordinateur partagé avec quelqu'un d'autre.

Un cas particulier : l'ordinateur partagé

Si vous utilisez un ordinateur familial ou un poste partagé avec d'autres personnes qui utilisent aussi Git, le réglage --global s'appliquera à tout le monde sur cette session utilisateur. Dans ce cas précis, il peut être plus judicieux de configurer l'identité projet par projet, sans --global, directement dans le dossier de chaque dépôt. Pour ce parcours, sur votre propre ordinateur, le réglage global reste la solution la plus simple.

Chapitre terminé