Formations — 1 037 leçons en français

Accueil › Git & CI/CD › Pourquoi réécrire l'historique

Pourquoi réécrire l'historique

Réécrire l'historiqueintermediaire

Un commit Git est immuable. Son identifiant est une empreinte calculée depuis son contenu, son message, sa date et l'empreinte de son parent.

git log --format="%h %p %s" -3
# 9f3c1ab 4b82d07 Ajouter la validation du panier
# 4b82d07 1e0a55c Extraire le calcul du total
# 1e0a55c 8ac19f2 Corriger le libellé du bouton

Chaque ligne contient l'empreinte du parent. Modifier un commit, c'est donc en fabriquer un nouveau et déplacer la branche dessus. L'ancien ne disparaît pas : il devient orphelin, et git reflog le retrouve.

L'effet domino

avant :  A — B — C — D — E        (main)
après  :  A — B — C'— D'— E'      (main)
                \
                 C — D — E        (orphelins)

Réécrire C réécrit aussi D et E, puisque chacun contient l'empreinte de son parent. Réécrire un commit ancien en réécrit toute la descendance.

Pourquoi le faire quand même

Parce qu'un historique se lit. Six commits « wip », « fix », « encore un fix » racontent votre après-midi, pas le code. Un commit par intention permet de relire, de bisecter, d'annuler proprement.

La seule question qui compte

Les commits sont… La réécriture est…
uniquement dans votre dépôt libre
poussés sur une branche partagée interdite sans accord explicite

Ce n'est pas l'âge du commit qui décide, c'est sa publication.

Les termes à connaître

Réécrire l'historique

Remplacer un ou plusieurs commits par de nouveaux commits. Git ne modifie jamais un commit : il en fabrique un autre, avec une nouvelle empreinte, et déplace la branche dessus. L'ancien devient orphelin.

Empreinte (SHA-1)

L'identifiant d'un commit, calculé à partir de son contenu, de son message, de sa date et de son parent. Changer n'importe lequel de ces éléments change l'empreinte — donc crée un commit différent.

Commit orphelin

Un commit qu'aucune branche ni étiquette n'atteint plus. Il reste dans le dépôt, retrouvable par reflog, jusqu'au passage du ramasse-miettes.

Historique public

Tout commit qui a été poussé sur un dépôt partagé, ou que quelqu'un d'autre a pu récupérer. C'est la frontière qui décide si une réécriture est permise.

git rebase

Rejoue une suite de commits sur une autre base. Chaque commit rejoué est un nouveau commit : même contenu, autre parent, autre empreinte.

Effet domino

Modifier un commit change l'empreinte de tous ses descendants, puisque chacun contient l'empreinte de son parent. Réécrire le troisième commit d'une série de dix en réécrit huit.

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.