Aller au contenu principal
Télécharger

refusing to merge unrelated histories — Comment corriger cette erreur Git

Git refuse de combiner deux branches qui ne partagent aucun ancêtre commun. Cela se produit généralement lorsque tu as initialisé un dépôt à la fois localement et sur GitHub. Voici comment corriger cette erreur.

Erreur fatale

Ce que cette erreur signifie

Chaque dépôt Git commence par un commit initial. Lorsque tu fusionnes ou fais un pull, Git recherche un ancêtre commun — un commit dont les deux branches descendent. C'est ainsi que Git détermine ce qui a changé de chaque côté.

Lorsque Git affiche "refusing to merge unrelated histories", cela signifie que les deux branches n'ont aucun ancêtre commun. Ce sont deux arbres de commits complètement indépendants qui n'ont jamais été connectés.

C'est une mesure de sécurité ajoutée dans Git 2.9. Sans elle, Git fusionnerait silencieusement deux projets non liés, ce qui n'est presque jamais ce que l'on souhaite par accident. La correction est simple : indiquer à Git que tu sais ce que tu fais avec un seul drapeau.

Pourquoi cette erreur se produit

Initialisation à la fois locale et sur GitHub

Tu as exécuté git init localement et fait un commit. Puis tu as créé un nouveau dépôt sur GitHub avec un README. Chacun possède son propre commit racine sans historique partagé. Lorsque tu essaies de faire un git pull, Git voit deux arbres non liés.

Fusion de deux dépôts distincts

Parfois, tu souhaites combiner deux projets indépendants en un seul. Tu ajoutes un dépôt comme remote de l'autre et tu essaies de fusionner. Comme ils ont été créés indépendamment, leurs historiques n'ont aucun ancêtre commun et Git refuse la fusion.

git init + remote add + pull

Un workflow courant chez les débutant·es : tu exécutes git init, ajoutes des fichiers, fais un commit, puis exécutes git remote add origin <url> suivi de git pull origin main. Si le dépôt distant a déjà des commits, ils sont sans lien avec les tiens.

Comment corriger

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

1. Pull avec --allow-unrelated-histories

2. Fusionner et résoudre les conflits

3. Rebaser sur le distant

Comment prévenir cette erreur

Cloner d'abord, coder ensuite

Crée ton dépôt sur GitHub en premier (avec ou sans README), puis fais un git clone sur ta machine. Cela garantit que tes dépôts local et distant partagent le même commit initial, et tu ne verras jamais cette erreur.

Pousser avant que GitHub ajouté des fichiers

Si tu préfères commencer localement, crée le dépôt GitHub sans README, licence, ou .gitignore. Puis ajoute le remote et pousse tes commits locaux. Comme le dépôt distant est vide, il n'y a pas d'historiques non liés en conflit.

Utiliser git clone pour les dépôts existants

N'exécute jamais git init dans un dossier pour ensuite essayer de le connecter à un dépôt distant existant. Utilise git clone <url> à la place, ce qui télécharge l'historique complet et configure le remote automatiquement.

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.

FAQ — refusing to merge unrelated histories

Maîtrise les fusions Git avec GitQuest

Pratique les fusions, les pulls et la résolution de conflits à travers des enquêtes interactives. Fini les doutes sur les drapeaux.