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.
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.