Que signifie "failed to push some refs" ?

Cette erreur signifie que la branche distante contient des commits que votre branche locale n'a pas. Git refuse de pousser car cela ecraserait ces commits distants. Vous devez d'abord integrer les modifications distantes dans votre branche locale, puis pousser a nouveau.

Dois-je utiliser git pull --rebase ou git pull pour corriger ?

Les deux fonctionnent. "git pull --rebase" rejoue vos commits locaux par-dessus les modifications distantes, creant un historique lineaire sans commit de merge. Un simple "git pull" cree un commit de merge. Le rebase est generalement prefere pour un historique plus propre, mais les deux approches resolvent l'erreur.

Quand est-il sur d'utiliser --force-with-lease ?

Utilisez --force-with-lease uniquement lorsque vous avez volontairement reecrit l'historique, par exemple apres un "git commit --amend" ou un "git rebase -i" sur des commits deja pousses. Ne faites jamais de force push sur une branche partagee sans vous coordonner avec votre equipe. Le drapeau --force-with-lease ajoute une verification de securite : il echoue si quelqu'un d'autre a pousse de nouveaux commits depuis votre dernier fetch.

Quelle est la difference entre --force et --force-with-lease ?

"git push --force" ecrase la branche distante inconditionnellement, meme si un coequipier a pousse de nouveaux commits. "git push --force-with-lease" n'ecrase que si la branche distante est exactement la ou vous l'attendez. Si quelqu'un d'autre a pousse entre-temps, --force-with-lease echoue et protege son travail. Preferez toujours --force-with-lease a --force.

J'obtiens cette erreur alors que personne d'autre n'a pousse. Pourquoi ?

Cela peut arriver si vous avez amende un commit, rebase localement, ou si un systeme CI/CD a pousse des modifications. Cela se produit aussi si vous avez pousse depuis une autre machine ou branche et l'avez oublie. Lancez "git fetch origin" puis "git log --oneline origin/main..HEAD" pour voir la difference entre vos branches locale et distante.

failed to push some refs Comment corriger cette erreur Git

Votre push a ete rejete car la branche distante contient des commits que vous n'avez pas localement. C'est l'une des erreurs Git les plus courantes, surtout en equipe. Voici comment la corriger en toute securite.

Apprendre Git pas a pas Glossaire Git

gitquest — enquête

Erreur expliquee

Ce que cette erreur signifie

Lorsque vous voyez error: failed to push some refs to 'origin', Git vous indique que la branche distante a avance par rapport a votre branche locale. Quelqu'un d'autre a pousse des commits, ou vous avez reecrit l'historique localement, et les deux branches ont maintenant diverge.

Git refuse de pousser car cela ecraserait des commits sur le distant que votre branche locale ne contient pas. C'est un mecanisme de securite pour eviter la perte de donnees.

La correction est simple : recuperez d'abord les modifications distantes dans votre branche locale, puis poussez a nouveau. Dans la plupart des cas, une seule commande suffit.

gitquest — erreur

# Vous essayez de pousser et voyez cette erreur

$git push origin main

To github.com:user/my-project.git

! [rejected] main -> main (fetch first)

error: failed to push some refs to 'github.com:user/my-project.git'

hint: Updates were rejected because the remote contains work that you do not

hint: have locally. Integrate the remote changes before pushing again.

Pourquoi cela se produit

Le plus courant

Quelqu'un d'autre a pousse en premier

Un coequipier a pousse de nouveaux commits sur la meme branche pendant que vous travailliez. Votre branche locale est maintenant en retard sur le distant. C'est la cause la plus frequente en environnement d'equipe et c'est tout a fait normal dans les workflows collaboratifs.

Apres reecriture

Vous avez rebase localement

Vous avez lance git rebase sur des commits deja pousses. Le rebase reecrit les hash de commit, donc Git voit votre branche locale comme divergente du distant meme si le contenu est similaire. Cela necessite un force push pour etre resolu.

Apres amend

Vous avez amende un commit pousse

Lancer git commit --amend sur le dernier commit change son hash. Si ce commit a deja ete pousse, les historiques distant et local ne correspondent plus. Vous aurez besoin de --force-with-lease pour mettre a jour le distant.

Comment corriger

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

Pull avec rebase (recommande)

gitquest — pull rebase

# Correctif 1 : Pull avec rebase, puis push (recommande)

$git pull --rebase origin main

remote: Enumerating objects: 5, done.

remote: Counting objects: 100% (5/5), done.

Successfully rebased and updated refs/heads/main.

$git push origin main

To github.com:user/my-project.git

f4e5d6c..a1b2c3d main -> main

Pull avec merge

gitquest — pull merge

# Correctif 2 : Pull avec merge, puis push

$git pull origin main

remote: Enumerating objects: 5, done.

Merge made by the 'ort' strategy.

README.md | 2 ++

1 file changed, 2 insertions(+)

$git push origin main

To github.com:user/my-project.git

f4e5d6c..b7c8d9e main -> main

Force push (apres reecriture uniquement)

gitquest — force push

# Correctif 3 : Force push (uniquement apres rebase/amend volontaire)

$git push --force-with-lease origin main

To github.com:user/my-project.git

+ a1b2c3d...f4e5d6c main -> main (forced update)

# --force-with-lease est plus sur que --force

# Il echoue si quelqu'un d'autre a pousse entre-temps

Comment prevenir cette erreur

Faire un pull avant de pousser

Prenez l'habitude de lancer git pull --rebase avant de pousser, surtout sur les branches partagees. Cela garantit que votre branche locale inclut tous les commits distants avant d'essayer d'envoyer les votres.

Utiliser des branches de fonctionnalite

Travaillez sur une branche dediee au lieu de commiter directement sur main. Les branches de fonctionnalite reduisent les conflits car moins de personnes poussent sur la meme branche simultanement. Fusionnez via des pull requests quand c'est pret.

Faire des fetch regulierement pour rester a jour

Lancez git fetch origin periodiquement tout au long de la journee. Cela telecharge les modifications distantes sans modifier votre repertoire de travail, vous permettant de voir si le distant a avance avant d'essayer de pousser.

Commandes associees

git push

Envoyer les commits locaux vers un depot distant

git pull

Recuperer et integrer les modifications distantes localement

git fetch

Telecharger les modifications distantes sans les fusionner

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

Maitrisez git push et pull sans prise de tete

GitQuest vous enseigne les workflows Git collaboratifs a travers des scenarios realistes. Plus d'erreurs de push mysterieuses.

Commencer a apprendre Git