Formations — 1 037 leçons en français

Accueil › Git & CI/CD › La règle d'or et le push forcé

La règle d'or et le push forcé

Réécrire l'historiqueintermediaire

Ne réécrivez jamais des commits que d'autres ont pu récupérer. Git ne vous en empêche pas : c'est à vous de tenir la règle.

Ce que voit le collègue

Vous rebasez une branche partagée et vous forcez. Son git pull ramène désormais deux versions du même travail :

A — B — C — D          (son historique local)
 \
  A — B'— C'— D'       (ce que le serveur annonce maintenant)

Son pull fabrique un commit de fusion qui additionne les deux. Les modifications apparaissent en double, blame devient illisible, et les conflits sont réels.

--force contre --force-with-lease

git push --force              # écrase, quoi qu'il y ait en face
git push --force-with-lease   # écrase seulement si le distant est là où je le crois

--force-with-lease compare la branche distante à votre référence de suivi origin/<branche>. Si quelqu'un a poussé depuis votre dernier fetch, la commande s'arrête.

Quand forcer est légitime

Situation Forcer ?
Votre branche de fonctionnalité, seul dessus oui, avec --force-with-lease
Une branche partagée avec un collègue seulement après accord explicite
main, develop, une branche de version non — à protéger côté forge

La vraie protection

La discipline ne suffit pas à l'échelle d'une équipe. Les forges proposent des branches protégées : le push forcé sur main est refusé par le serveur. C'est la seule garantie qui tienne.

Les termes à connaître

Règle d'or

Ne jamais réécrire des commits publiés sur une branche que d'autres utilisent. C'est une règle sociale, pas une protection technique : Git laisse faire.

git push --force

Remplace la branche distante par la vôtre, sans condition. Tout commit poussé entre-temps par quelqu'un d'autre est perdu de vue.

git push --force-with-lease

Pousse de force seulement si la branche distante est encore à l'empreinte que votre dépôt croit. Sinon, la commande est refusée.

Référence de suivi

origin/main et consorts : la copie locale de l'état distant, mise à jour par fetch et pull. C'est sur elle que --force-with-lease fonde sa comparaison.

--force-if-includes

Option qui complète --force-with-lease en exigeant que les commits distants aient réellement été intégrés localement. Elle neutralise le fetch automatique d'un éditeur ou d'un outil de fond.

Branche protégée

Réglage de la forge interdisant le push forcé sur une branche donnée. La seule façon fiable de faire respecter la règle d'or sur main.

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.