Formations — 1 037 leçons en français

Accueil › Git & CI/CD › reflog, reset et revert : défaire sans détruire

reflog, reset et revert : défaire sans détruire

Conflits et commandes de sauvetageintermediaire

Trois outils, trois usages qui ne se recouvrent pas.

git reflog                    # où suis-je passé ? (local, 90 jours)
git reset <mode> <commit>     # déplacer la branche (réécrit : local seulement)
git revert <commit>           # annuler en ajoutant un commit (sûr, partagé)

Le reflog

7a3c9f1 HEAD@{0}: reset: moving to HEAD~3
1d4e8b2 HEAD@{1}: commit: ajoute le calcul de remise
9c0a5f7 HEAD@{2}: checkout: moving from main to refonte

Chaque déplacement de HEAD laisse une ligne. Un commit « perdu » par un reset, un rebase raté, une branche supprimée : tout cela est encore là, et le reflog donne son empreinte.

git reset --hard HEAD@{1}     # revenir où j'étais avant la bêtise

reset contre revert

reset revert
Effet déplace la branche ajoute un commit
Historique réécrit conservé
Sur une branche poussée non oui
Trace de l'erreur aucune visible

La règle tient en une phrase : reset pour ce qui n'est pas publié, revert pour ce qui l'est. Un reset sur une branche partagée oblige à forcer le push, et fait disparaître sous les pieds des autres des commits qu'ils ont déjà récupérés.

Les termes à connaître

reflog

Journal local de tous les déplacements d'une référence. Chaque fois que HEAD ou une branche change de commit, une ligne est ajoutée. C'est ce qui rend presque toute erreur réversible.

HEAD@{n}

La position qu'occupait HEAD il y a n mouvements. À ne pas confondre avec HEAD~n, qui désigne l'ancêtre de rang n dans l'historique — deux notions sans rapport.

ORIG_HEAD

Référence écrite automatiquement avant une opération risquée (merge, rebase, reset). git reset --hard ORIG_HEAD ramène à l'état d'avant, sans avoir à lire le reflog.

reset --soft

Déplace la branche, et laisse l'index et le répertoire de travail intacts. Les modifications des commits défaits se retrouvent prêtes à être recommittées.

reset --mixed

Le défaut. Déplace la branche et remet l'index à niveau, sans toucher aux fichiers. Les modifications redeviennent « non indexées ».

reset --hard

Déplace la branche, l'index et les fichiers. La seule des trois qui détruit du travail non commité — et ce travail-là, le reflog ne le retrouvera pas.

revert

Crée un nouveau commit qui applique l'inverse d'un commit existant. Rien n'est effacé, donc l'opération est sûre sur une branche partagée.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.