Des rites de passage, pas des catastrophes
Toutes les erreurs de cette leçon ont un point commun : elles arrivent à tout le monde, et aucune n’est grave.
Le problème n’est donc pas l’erreur, c’est ce qu’elle provoque. Un message rouge incompréhensible, à la troisième semaine d’utilisation, suffit à faire abandonner quelqu’un qui retournera à son partage réseau en concluant que « Git, c’est compliqué ».
Cette leçon existe pour que cela ne vous arrive pas. Elle est aussi faite pour être consultée plus tard, quand un message vous surprendra.
Deux niveaux de dépannage dans cette formation. Cette leçon couvre les tracas des premières semaines, tous bénins. Pour les situations réellement inconfortables — un travail qui semble perdu, un historique cassé, une mauvaise version partie en production — une annexe autonome leur est consacrée : Les catastrophes du vendredi 17h. Nous la présentons en fin de leçon.
Les trois réflexes
Avant toute chose, ces trois commandes couvrent 90 % des situations.
git status # où j'en suis, et ce que Git me suggère
git log --oneline -5 # ce qui s'est passé récemment
git reflog # tout ce que j'ai fait, y compris ce que j'ai annulé
git status est le premier réflexe. Git y indique presque toujours la commande suivante entre parenthèses. Prenez l’habitude de lire ces suggestions plutôt que de chercher ailleurs.
Famille 1 — Démarrage et configuration
| Symptôme | Ce qui se passe | La solution |
|---|---|---|
Please tell me who you are |
user.name et user.email ne sont pas configurés |
Leçon 1.6 : les deux git config --global |
| Vous êtes coincé dans un écran noir | -m oublié : Git a ouvert Vim |
:q! pour sortir, puis configurez votre éditeur |
git status liste des centaines de fichiers |
git init lancé dans un dossier trop haut, ou dans votre profil |
Supprimez le dossier .git créé, recommencez au bon endroit |
not a git repository |
Vous n’êtes pas dans un dépôt | cd vers le bon dossier — vérifiez avec ls -a |
⚠️ Ne supprimez jamais le dossier .git d’un dépôt réel. Il est l’historique. Le supprimer ne laisse que des fichiers ordinaires, sans mémoire. La seule exception est celle du tableau ci-dessus : un .git créé par erreur dans un dossier qui n’a rien à voir.
Famille 2 — Le cycle quotidien
| Symptôme | Ce qui se passe | La solution |
|---|---|---|
nothing to commit alors que vous avez modifié |
Rien n’a été posé sur le plateau | git add <fichier> |
| Un nouveau fichier manque à l’enregistrement | git commit -a ignore les fichiers non suivis |
git add explicite pour les nouveaux |
| Message de commit raté | Faute de frappe, message vide de sens | git commit --amend -m "..." — avant publication |
| Vous avez oublié un fichier dans le dernier commit | git add <fichier> puis git commit --amend --no-edit |
|
| Vous avez enregistré deux sujets sans rapport | Un git add . un peu rapide |
git reset --soft HEAD~1, puis recomposez |
Le cas du git add . trop rapide est le plus fréquent. La parade tient en une habitude : git status avant chaque add, git diff --staged avant chaque commit. Dix secondes qui évitent la moitié de ce tableau.
Famille 3 — Les échanges avec la forge
| Symptôme | Ce qui se passe | La solution |
|---|---|---|
Authentication failed |
Jeton absent, ou vous avez saisi votre mot de passe | Leçon 3.1 — le jeton remplace le mot de passe |
Authentication failed avec un jeton neuf |
L’ancien est encore mémorisé | git credential reject (leçon 3.1) |
403 Forbidden |
Vous êtes identifié mais sans droit d’écriture | Question de permissions d’équipe (leçon 2.9) |
Updates were rejected (fetch first) |
Le serveur a avancé | git pull puis git push (leçon 3.4) |
There is no tracking information |
Pas de lien de suivi sur la branche | git push -u origin main |
| Erreur de vérification de certificat | L’autorité interne n’est pas installée | Installez la CA — jamais sslVerify false |
413 Request Entity Too Large |
Limite du reverse proxy | Côté serveur : leçon 2.3 |
Repository not found |
URL erronée, ou dépôt privé sans accès | Vérifiez avec git remote -v |
Rappel utile : 401 signifie « je ne sais pas qui vous êtes » — problème de jeton. 403 signifie « je sais qui vous êtes, mais vous n’avez pas le droit » — problème de permissions. Deux endroits différents où chercher.
Famille 4 — Les fichiers
| Symptôme | Ce qui se passe | La solution |
|---|---|---|
| Un fichier indésirable est parti sur la forge | .gitignore absent ou incomplet |
Leçon 3.6 : git rm --cached + règle |
| Un fichier ignoré apparaît quand même | Il était déjà suivi avant la règle | git rm --cached <fichier> |
| Git annonce 400 lignes modifiées alors que vous n’avez rien touché | Fins de ligne CRLF / LF | Leçon 1.6 : core.autocrlf |
| Un script Bash ne s’exécute plus sur Linux | Même cause : bad interpreter: ^M |
Idem |
| Un dossier vide a disparu au clone | Git ne suit pas les dossiers | Ajoutez-y un .gitkeep |
| Le dépôt est devenu énorme | Un fichier volumineux a été enregistré | Voir section 5 — il reste dans l’historique |
| Des accents dans les noms de fichiers posent problème | Encodage entre Windows et Linux | Évitez accents et espaces dans les noms |
Famille 5 — « Je ne sais plus où j’en suis »
C’est moins une erreur qu’un moment de flottement, et il arrive à tout le monde.
git status # dans quel état suis-je ?
git branch # sur quelle branche ?
git remote -v # relié à quoi ?
git log --oneline -5 # qu'ai-je fait récemment ?
Quatre commandes, aucune ne modifie quoi que ce soit. Elles répondent à « où suis-je, et que s’est-il passé ».
Et si vous êtes au milieu d’une opération que vous ne comprenez pas :
git merge --abort # annuler une fusion en cours
git rebase --abort # annuler un rebase en cours
Tout revient à l’état d’avant, sans rien perdre. N’hésitez jamais à les utiliser. Mieux vaut recommencer calmement que persévérer dans une situation qu’on ne comprend pas.
Les trois habitudes qui évitent presque tout
git status avant et après chaque action. C’est la commande la plus utile de Git, et la moins utilisée par les débutants.
Un enregistrement avant toute manipulation risquée. Dix secondes de git commit, et vous passez du côté récupérable de la frontière — celui où le reflog peut vous sauver.
Tirer en début de session, publier en fin de journée. Réduit les conflits, protège votre travail, et évite les mauvaises surprises du lundi.
Quand ça va vraiment mal : l’annexe
Les situations ci-dessus sont bénignes. Il en existe d’autres, plus inconfortables — et elles surviennent rarement au bon moment.
Les catastrophes du vendredi 17h est une page de référence autonome, consultable sans avoir à suivre la formation, conçue pour être lue en situation d’urgence.
Elle s’organise autour de deux principes.
Le réflexe n°0 — ne touchez à rien, copiez le dossier, puis git status et git reflog. La plupart des aggravations viennent de la deuxième commande tapée dans la panique.
La question de tri — est-ce que c’est déjà poussé ? Tant que c’est local, on peut tout réécrire. Une fois publié, on répare en avançant, jamais en réécrivant. C’est la règle d’or de la leçon 3.8, et elle détermine la marche à suivre dans chaque cas.
Les quinze fiches sont réparties en trois familles :
| Famille | Exemples |
|---|---|
| C’est encore local | Fichier oublié, reset --hard malheureux, branche supprimée, detached HEAD, fusion bloquée |
| C’est déjà poussé | Enregistrement direct sur main, force push d’un collègue, mauvais tag parti sur 200 postes |
| Git ne vous sauvera pas | Mot de passe enregistré, dépôt supprimé sur la forge |
Chaque fiche suit la même trame : Symptôme → Ce qui s’est passé → ❌ Ne faites surtout pas ça → ✅ La manipulation → Vérifier que c’est réparé.
Mettez-la en favori maintenant. Le jour où vous en aurez besoin, vous n’aurez pas le temps de la chercher.
Ce qu’il faut retenir
- Aucune des erreurs de cette leçon n’est grave — elles arrivent à tout le monde.
git statusest le premier réflexe : Git y suggère presque toujours la commande suivante.401= problème d’identité ·403= problème de droits.--amendrépare un enregistrement raté, tant qu’il n’est pas publié.merge --abortetrebase --abortannulent sans rien perdre : utilisez-les sans hésiter.- Ne supprimez jamais le
.gitd’un dépôt réel. - Trois habitudes évitent presque tout :
statussystématique, enregistrer avant de risquer, tirer et publier régulièrement. - Pour les situations d’urgence, l’annexe Les catastrophes du vendredi 17h est faite pour être consultée sans rien relire.
Dans la leçon suivante
La section 3 s’achève. Vous savez authentifier votre poste, publier un dépôt, travailler au quotidien, récupérer le travail des autres, résoudre un conflit, protéger votre dépôt, enquêter dans l’historique, revenir en arrière et récupérer ce qui semblait perdu.
Le TP 3 reprend l’ensemble sur le dépôt de scripts de Nordika, à deux voix : vous jouerez tour à tour les deux administrateurs, avec deux copies du dépôt, pour provoquer — et résoudre — un vrai conflit.
Puis la section 4 introduira les branches, et avec elles la possibilité de travailler sans jamais toucher à ce qui part en production.