Aller au contenu principal
Télécharger

failed to push some refs Comment corriger cette erreur Git

Ton push a été rejeté car la branche distante contient des commits que tu n'as pas localement. C'est l'une des erreurs Git les plus courantes, surtout en équipe. Voici comment la corriger en toute sécurité.

GitQuest
Démo
Erreur expliquée

Ce que cette erreur signifie

Lorsque tu vois error: failed to push some refs to 'origin', Git t'indique que la branche distante a avancé par rapport à ta branche locale. Quelqu'un d'autre a poussé des commits, ou tu as réécrit l'historique localement, et les deux branches ont maintenant divergé.

Git refuse de pousser car cela écraserait des commits sur le distant que ta branche locale ne contient pas. C'est un mécanisme de sécurité pour éviter la perte de données.

La correction est simple : récupère d'abord les modifications distantes dans ta branche locale, puis pousse à nouveau. Dans la plupart des cas, une seule commande suffit.

Pourquoi cela se produit

Le plus courant

Quelqu'un d'autre a poussé en premier

Un coéquipier a poussé de nouveaux commits sur la même branche pendant que tu travaillais. Ta branche locale est maintenant en retard sur le distant. C'est la cause la plus fréquente en environnement d'équipe et c'est tout à fait normal dans les workflows collaboratifs.

Après réécriture

Tu as rebasé localement

Tu as lancé git rebase sur des commits déjà poussés. Le rebase réécrit les hash de commit, donc Git voit ta branche locale comme divergente du distant même si le contenu est similaire. Cela nécessite un force push pour être résolu.

Après amend

Tu as amendé un commit poussé

Lancer git commit --amend sur le dernier commit change son hash. Si ce commit a déjà été poussé, les historiques distant et local ne correspondent plus. Tu auras besoin de --force-with-lease pour mettre à jour le distant.

Comment corriger

Trois approches selon ta situation. Commence par pull --rebase, qui fonctionne dans la plupart des cas et garde un historique propre.

Pull avec rebase (recommandé)

Pull avec merge

Force push (après réécriture uniquement)

Comment prévenir cette erreur

Faire un pull avant de pousser

Prends l'habitude de lancer git pull --rebase avant de pousser, surtout sur les branches partagées. Cela garantit que ta branche locale inclut tous les commits distants avant d'essayer d'envoyer les tiens.

Utiliser des branches de fonctionnalité

Travaille sur une branche dédiée au lieu de commiter directement sur main. Les branches de fonctionnalité réduisent les conflits car moins de personnes poussent sur la même branche simultanément. Fusionne via des pull requests quand c'est prêt.

Faire des fetch régulièrement pour rester à jour

Lance git fetch origin périodiquement tout au long de la journée. Cela télécharge les modifications distantes sans modifier ton répertoire de travail, te permettant de voir si le distant a avancé avant d'essayer de pousser.

A

GitQuest est conçu par Anaïs (nouvelle fenêtre), développeuse web et responsable pédagogique, spécialisée en formations tech et accessibilité numérique.

Questions sur cette erreur

Maîtrise git push et pull sans prise de tête

GitQuest t'enseigne les workflows Git collaboratifs à travers des scénarios réalistes. Plus d'erreurs de push mystérieuses.