Formations — 1 037 leçons en français

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

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.