Accueil › Git & CI/CD › Rebase : réécrire, et ce qu'il ne faut jamais toucher
Rebase : réécrire, et ce qu'il ne faut jamais toucher
Branches, fusion et conflitsdebutant
Fusionner conserve l'histoire telle qu'elle s'est passée. Rebaser la réécrit pour qu'elle paraisse linéaire.
Avant Après git rebase main
A───B───C───F (main) A───B───C───F (main)
╲ ╲
D───E (ma-branche) D'───E' (ma-branche)
D' et E' ont le même contenu que D et E, mais pas la même empreinte : l'empreinte dépend aussi du parent, qui a changé.
git switch ma-branche
git rebase main
git push --force-with-lease # l'historique a changé : il faut forcer
La règle d'or : on ne rebase jamais ce que d'autres ont déjà récupéré. Sur votre branche personnelle, avant la relecture : oui. Sur main ou une branche à plusieurs : jamais. Le collègue qui avait l'ancienne version se retrouverait avec deux histoires parallèles contenant les mêmes changements.
Le rebase interactif est l'autre usage, et le plus utile au quotidien :
git rebase -i main
pick 7d2e8b1 Vider le panier côté service
squash a3f91c2 wip
squash 4e8c0d9 fix typo
reword 8f2a1c3 Ajouter le bouton
Six commits bricolés deviennent deux commits lisibles — avant que quiconque ne les lise.
Les termes à connaître
- Rebase
Rejoue les commits d'une branche par-dessus un autre commit de base. Les commits d'origine ne sont pas déplacés : de nouveaux commits sont créés, avec un contenu identique mais une empreinte différente.
- Rebase interactif
git rebase -iouvre la liste des commits à rejouer, pour les réordonner, les fusionner (squash), les reformuler (reword) ou les supprimer (drop). L'outil de nettoyage d'une branche avant relecture.- La règle d'or
Ne jamais réécrire un historique que d'autres ont déjà récupéré. Un rebase sur une branche partagée oblige chacun à réparer son dépôt, et fait perdre du travail à ceux qui s'y prennent mal.
- squash
Fusionner plusieurs commits en un seul. Transforme six commits « wip » en un commit lisible — à faire avant la relecture, jamais après.
- --force-with-lease
Pousse en forçant, mais refuse si quelqu'un a poussé entre-temps. À utiliser systématiquement à la place de
--force, qui écrase sans vérifier.- pull --rebase
Récupère les commits distants et rejoue les vôtres par-dessus, au lieu de créer un commit de fusion. Évite les commits « Merge branch main into main » qui polluent l'historique.
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.