fatal: refusing to merge unrelated histories
Cele două branch-uri nu au niciun commit comun, de obicei pentru că ai creat repository-ul pe GitHub cu un README și separat ai făcut git init local. Dacă chiar vrei să le unești, rulează git pull origin main --allow-unrelated-histories, rezolvă conflictele, apoi git push.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un merge obișnuit pornește de la un strămoș comun al celor două branch-uri. Când istoriile nu au niciun commit comun, Git (de la versiunea 2.9) refuză merge-ul, pentru că de cele mai multe ori e o greșeală: ai legat proiectul de alt repository decât credeai.
Cazul tipic pentru începători: creezi repository-ul pe GitHub bifând „Add a README”, deci pe server există deja un commit; local faci git init, câteva commit-uri și git remote add origin. Primul git push e respins (fetch first), iar git pull dă acest mesaj, pentru că cele două istorii au pornit separat. Dacă ești sigur că e repository-ul corect, opțiunea --allow-unrelated-histories permite merge-ul. Dacă pe server e doar un README generat, poți să-l unești sau să-l înlocuiești.
De ce apare: cauzele frecvente
1Repository creat pe GitHub cu README, plus git init local
git remote add origin https://github.com/elev/retete.git
git pull origin maingit pull origin main --allow-unrelated-histories
git push -u origin mainOpțiunea permite merge-ul a două istorii fără strămoș comun. Rezultatul are un commit de merge cu ambele.
2Ai legat proiectul de un repository greșit
git remote add origin https://github.com/elev/alt-proiect.git
git pull origin maingit remote set-url origin https://github.com/elev/retete.git
git pull origin mainAici refuzul te-a protejat: corectezi adresa, nu forțezi merge-ul.
3Ai refăcut .git (rm -rf .git, apoi git init)
rm -rf .git
git init
git add .
git commit -m "Din nou"
git pullgit clone https://github.com/elev/retete.git retete-curat
# copiază modificările în clona nouăUn git init nou începe o istorie nouă, fără legătură cu cea de pe server. O clonă proaspătă păstrează istoria.
Repară eroarea, direct în pagină
Ai creat repository-ul retete pe GitHub cu un README.md, iar local ai făcut git init și un commit cu index.html. Push-ul e respins, iar în Git-ul real git pull origin main dă fatal: refusing to merge unrelated histories. Unește cele două istorii (păstrând ambele fișiere) cu opțiunea potrivită și urcă main, fără push forțat.
Indiciu
git pull are o opțiune care permite unirea istoriilor fără strămoș comun.
Reparația
Vezi respingerea push-ului, apoi adu și unește istoria de pe GitHub:
git push -u origin main
git pull origin main --allow-unrelated-historiesGit creează un commit de merge care are ca părinți ambele istorii. Acum urcă:
git push -u origin mainRezultat: pe main sunt atât README.md (de pe GitHub), cât și index.html (local), iar push-ul e acceptat.
De ce merge
Commit-ul Initial commit de pe GitHub și commit-ul tău local au pornit fiecare de la zero, deci nu aveau un strămoș comun, iar Git-ul real refuză un astfel de merge fără confirmare (simulatorul nostru nu face acest refuz, de aceea verificarea cere explicit opțiunea). --allow-unrelated-histories confirmă că istoriile țin de același proiect. Commit-ul de merge le leagă, iar istoria ta conține acum și commit-ul de pe server, deci push-ul nu mai șterge nimic.
Alte forme ale mesajului
fatal: refusing to merge unrelated histories Error redoing merge 3f2a1b4
Cum o eviți pe viitor
- Când ai deja proiectul local, creează repository-ul pe GitHub gol (fără README, licență sau .gitignore).
- Când proiectul există deja pe GitHub, pornește cu
git clone, nu cugit init. - Nu șterge folderul
.gitca să „repari” ceva: pierzi legătura cu istoria de pe server.
Întrebări frecvente
E periculos --allow-unrelated-histories?
Nu strică nimic, dar poate uni două proiecte care n-au legătură. Folosește-l doar când știi că cele două istorii aparțin aceluiași proiect.
De ce nu dă eroarea la git push?
Push-ul nu face merge: e respins cu fetch first, pentru că serverul are commit-uri pe care nu le ai. Refuzul apare la pasul următor, git pull.
Erori înrudite
hint: Updates were rejected because the remote contains work that you do not have locally. Pe GitHub există commit-uri (ale unui coleg sau făcute din interfața web) pe care tu nu le ai local, așa că push-ul tău le-ar șterge. Adu-le întâi cu git pull (sau git pull --rebase), rezolvă eventualele conflicte, apoi git push din nou. hint: You have divergent branches and need to specify how to reconcile them. Și tu, și serverul aveți commit-uri noi, iar Git nu știe dacă să le combine prin merge sau prin rebase. Alege o dată: git config pull.rebase false (merge) sau git config pull.rebase true (rebase), apoi rulează din nou git pull. fatal: 'origin' does not appear to be a git repository Repository-ul tău nu are niciun remote numit origin, deci Git tratează cuvântul ca pe o cale și nu găsește nimic acolo. Adaugă remote-ul cu git remote add origin URL (verifică cu git remote -v), apoi git push -u origin main. Învață Git de la zero, cu exerciții la fiecare lecție
Curs Git: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
