3.11 : Les erreurs classiques du débutant

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 status est le premier réflexe : Git y suggère presque toujours la commande suivante.
  • 401 = problème d’identité · 403 = problème de droits.
  • --amend répare un enregistrement raté, tant qu’il n’est pas publié.
  • merge --abort et rebase --abort annulent sans rien perdre : utilisez-les sans hésiter.
  • Ne supprimez jamais le .git d’un dépôt réel.
  • Trois habitudes évitent presque tout : status systé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.