Que signifie "refusing to merge unrelated histories" ?

Cela signifie que Git a trouve deux branches qui ne partagent aucun commit ancetre commun. Dans un depot normal, toutes les branches descendent du meme commit initial. Lorsque Git detecte deux arbres de commits completement independants, il refuse de les fusionner automatiquement car il ne peut pas determiner comment les combiner sans autorisation explicite.

Est-ce que --allow-unrelated-histories est sans risque ?

Oui, c'est sans risque. Ce drapeau indique simplement a Git de proceder a la fusion malgre l'absence d'ancetre commun. Vous pourriez obtenir des conflits de fusion si les deux historiques contiennent des fichiers portant le meme nom, mais c'est le meme principe que pour tout autre conflit de fusion. Resolvez-les normalement et validez.

Pourquoi cette erreur est-elle apparue a partir de Git 2.9 ?

Avant Git 2.9, la fusion d'historiques non lies etait autorisee par defaut. Les mainteneurs de Git ont ajoute cette verification de securite car fusionner accidentellement des depots non lies pouvait creer un historique confus. Le drapeau --allow-unrelated-histories a ete introduit pour que vous puissiez toujours le faire intentionnellement.

Comment eviter cette erreur lors de la creation d'un nouveau depot ?

L'approche la plus simple est de creer le depot sur GitHub en premier (avec un README si vous le souhaitez), de le cloner localement avec "git clone", puis de commencer a ajouter votre code. Cela garantit que le depot local et le depot distant partagent le meme commit initial. Sinon, initialisez localement, faites votre premier commit, puis ajoutez le depot distant et poussez avant que GitHub ne cree des fichiers.

Puis-je utiliser rebase au lieu de merge pour corriger cette erreur ?

Oui. Vous pouvez executer "git fetch origin" suivi de "git rebase origin/main" pour rejouer vos commits locaux au-dessus de l'historique distant. Cela evite un commit de fusion et cree un historique lineaire. Cependant, si les deux cotes ont beaucoup de commits, le rebase peut etre plus complexe qu'une simple fusion avec --allow-unrelated-histories.

refusing to merge unrelated histories — Comment corriger cette erreur Git

Git refuse de combiner deux branches qui ne partagent aucun ancetre commun. Cela se produit generalement lorsque vous avez initialise un depot a la fois localement et sur GitHub. Voici comment corriger cette erreur.

Apprendre Git pas a pas

Erreur fatale

Ce que cette erreur signifie

Chaque depot Git commence par un commit initial. Lorsque vous fusionnez ou faites un pull, Git recherche un ancetre commun — un commit dont les deux branches descendent. C'est ainsi que Git determine ce qui a change de chaque cote.

Lorsque Git affiche "refusing to merge unrelated histories", cela signifie que les deux branches n'ont aucun ancetre commun. Ce sont deux arbres de commits completement independants qui n'ont jamais ete connectes.

C'est une mesure de securite ajoutee dans Git 2.9. Sans elle, Git fusionnerait silencieusement deux projets non lies, ce qui n'est presque jamais ce que l'on souhaite par accident. La correction est simple : indiquer a Git que vous savez ce que vous faites avec un seul drapeau.

terminal — unrelated histories

$git pull origin main

fatal: refusing to merge unrelated histories

Pourquoi cette erreur se produit

Initialisation a la fois locale et sur GitHub

Vous avez execute git init localement et fait un commit. Puis vous avez cree un nouveau depot sur GitHub avec un README. Chacun possede son propre commit racine sans historique partage. Lorsque vous essayez de faire un git pull, Git voit deux arbres non lies.

Fusion de deux depots distincts

Parfois, vous souhaitez combiner deux projets independants en un seul. Vous ajoutez un depot comme remote de l'autre et essayez de fusionner. Comme ils ont ete crees independamment, leurs historiques n'ont aucun ancetre commun et Git refuse la fusion.

git init + remote add + pull

Un workflow courant chez les debutants : vous executez git init, ajoutez des fichiers, faites un commit, puis executez git remote add origin <url> suivi de git pull origin main. Si le depot distant a deja des commits, ils sont sans lien avec les votres.

Comment corriger

Trois approches selon votre situation : pull avec le drapeau, fusion manuelle, ou rebase.

1. Pull avec --allow-unrelated-histories

terminal — correctif pull

# Autoriser la fusion de deux arbres de commits non lies

$git pull origin main --allow-unrelated-histories

Merge made by the 'ort' strategy.

README.md | 3 +++

1 file changed, 3 insertions(+)

create mode 100644 README.md

2. Fusionner et resoudre les conflits

terminal — correctif merge

# Si vous fusionnez un autre depot comme sous-repertoire

$git merge other-repo/main --allow-unrelated-histories

Auto-merging README.md

CONFLICT (add/add): Merge conflict in README.md

Automatic merge failed; fix conflicts and then commit.

# Resoudre les conflits, puis :

$git add .

$git commit -m "Merge unrelated histories"

[main 4f7a8b2] Merge unrelated histories

3. Rebaser sur le distant

terminal — correctif rebase

# Alternative : repartir sur la base du depot distant

$git remote add origin https://github.com/user/repo.git

$git fetch origin

$git rebase origin/main

Successfully rebased and updated refs/heads/main.

# Vos commits locaux sont maintenant au-dessus de l'historique distant

Comment prevenir cette erreur

Cloner d'abord, coder ensuite

Creez votre depot sur GitHub en premier (avec ou sans README), puis faites un git clone sur votre machine. Cela garantit que vos depots local et distant partagent le meme commit initial, et vous ne verrez jamais cette erreur.

Pousser avant que GitHub ajoute des fichiers

Si vous preferez commencer localement, creez le depot GitHub sans README, licence, ou .gitignore. Puis ajoutez le remote et poussez vos commits locaux. Comme le depot distant est vide, il n'y a pas d'historiques non lies en conflit.

Utiliser git clone pour les depots existants

N'executez jamais git init dans un dossier pour ensuite essayer de le connecter a un depot distant existant. Utilisez git clone <url> a la place, ce qui telecharge l'historique complet et configure le remote automatiquement.

Commandes associees

git merge

Combiner des branches et comprendre les strategies de fusion

git pull

Recuperer et integrer les modifications depuis un depot distant

git remote

Gerer les connexions aux depots distants

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.

FAQ — refusing to merge unrelated histories

Maitrisez les fusions Git avec GitQuest

Pratiquez les fusions, les pulls et la resolution de conflits a travers des enquetes interactives. Fini les doutes sur les drapeaux.

Commencer a apprendre Git