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