Que signifie "Your local changes would be overwritten" ?

Vous avez des modifications non commitees dans des fichiers que l'operation doit mettre a jour. Git refuse de continuer car cela ecraserait votre travail. C'est un mecanisme de securite. Vos modifications sont toujours intactes.

Quelle est la difference entre stash et commit pour corriger cette erreur ?

Le stash met temporairement de cote vos modifications pour les restaurer plus tard avec "git stash pop". Le commit les sauvegarde definitivement dans l'historique. Utilisez stash quand votre travail n'est pas pret a etre commite. Utilisez commit quand il represente une unite de travail complete.

Est-ce que "git stash pop" peut provoquer des conflits ?

Oui. Si l'operation que vous avez effectuee apres le stash a modifie les memes fichiers, le pop du stash peut produire des conflits de merge. Resolvez-les en modifiant le fichier, en supprimant les marqueurs de conflit et en lancant "git add".

Peut-on forcer Git a ecraser les modifications locales ?

Oui, mais c'est risque. "git checkout -f " ou "git reset --hard" supprimera definitivement toutes les modifications non commitees. N'utilisez cela que si vous etes certain de ne pas avoir besoin de vos modifications locales.

Comment eviter cette erreur a l'avenir ?

Commitez ou mettez de cote avant de faire un pull ou de changer de branche. Vous pouvez aussi utiliser "git pull --autostash" qui fait le stash automatiquement. Configurez-le par defaut avec "git config --global rebase.autoStash true".

Your local changes would be overwritten by merge

Git protege votre travail non commite. Cette erreur signifie que vous avez des modifications non sauvegardees dans des fichiers que l'operation doit mettre a jour. Voici trois facons de corriger ce probleme en toute securite.

Apprendre Git avec GitQuest Voir la solution

gitquest — enquête

Explication de l'erreur

Ce que cette erreur signifie

Lorsque Git doit mettre a jour des fichiers contenant des modifications non commitees, il refuse de continuer pour proteger votre travail. C'est un mecanisme de securite, pas un bug. Vous verrez cette erreur lors d'un git pull, git checkout ou git merge.

gitquest — ecrasement par merge

$git pull origin main

error: Your local changes to the following files would be overwritten by merge:

src/config.ts

Please commit your changes or stash them before you merge.

Aborting

gitquest — ecrasement par checkout

$git checkout feature/dashboard

error: Your local changes to the following files would be overwritten by checkout:

src/config.ts

Please commit your changes or stash them before you switch branches.

Causes principales

Pourquoi cela se produit

Pull avec des modifications non commitees

Vous avez modifie des fichiers localement sans les commiter ni les mettre de cote. Quand git pull tente de fusionner les modifications distantes dans ces memes fichiers, Git bloque l'operation pour proteger votre travail.

Changement de branche avec des fichiers modifies

Vous avez des modifications non commitees dans des fichiers qui different entre les branches. Git ne peut pas changer de branche sans ecraser vos modifications, il s'arrete donc et vous avertit.

Conflits de stash pop ou apply

Si vous avez des modifications et essayez d'appliquer un stash qui touche les memes fichiers, Git vous avertit que vos modifications actuelles seraient ecrasees par le contenu du stash.

Trois facons de corriger

Comment corriger

Choisissez l'option qui correspond a votre situation. Le stash est la solution la plus sure quand votre travail n'est pas pret a etre commite.

Option 1 : Stash, operation, restauration Recommande

gitquest — corriger avec git stash

# Mettre de cote les modifications, effectuer l'operation, les restaurer

$git stash

Saved working directory and index state WIP on main: a1b2c3d Latest commit

$git pull origin main

Updating a1b2c3d..e4f5g6h

$git stash pop

Dropped refs/stash@{0}

Option 2 : Commiter d'abord

gitquest — corriger avec git commit

# Commiter votre travail d'abord, puis effectuer l'operation

$git add src/config.ts

$git commit -m "Save work in progress on config"

[main f7g8h9i] Save work in progress on config

$git pull origin main

Already up to date.

Option 3 : Supprimer les modifications locales Destructif

gitquest — corriger en supprimant les modifications

# Supprimer les modifications locales (ATTENTION : perte de travail)

$git restore src/config.ts

# Ancien Git : git checkout -- src/config.ts

$git pull origin main

Updating a1b2c3d..e4f5g6h

Fast-forward

Bonnes pratiques

Comment eviter cette erreur

Commitez ou stashez avant de pull

Commitez ou mettez de cote toujours avant un git pull ou un changement de branche. Prenez cette habitude et vous ne verrez plus jamais cette erreur.

Utilisez git pull --autostash

Le flag --autostash met de cote avant le pull et restaure apres. Configurez-le par defaut : git config --global rebase.autoStash true.

Verifiez git status d'abord

Lancez git status avant toute operation de branche. Si vous voyez des fichiers modifies, commitez, stashez ou supprimez-les avant de continuer.

Commandes associees

git stash

Sauvegarder temporairement les modifications non commitees

git checkout

Changer de branche ou restaurer des fichiers

git restore

Annuler les modifications du repertoire de travail

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 Git

Arretez de deviner, comprenez Git

GitQuest vous apprend Git a travers des enquetes pratiques et des scenarios reels. Apprenez a gerer les erreurs en toute confiance.

Commencer a apprendre