warning: Cannot merge binary files: logo.png (HEAD vs. feature/design)
Ambele branch-uri au modificat același fișier binar (imagine, PDF, arhivă), iar Git nu poate combina două imagini linie cu linie. Alegi una dintre versiuni cu git checkout --ours sau --theirs, apoi git add și git commit.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
La un fișier text, Git compară liniile și pune markeri de conflict doar acolo unde ambele părți au modificat același loc. Un fișier binar (.png, .jpg, .pdf, .zip, .xlsx) nu are linii, deci nu există o combinare automată. Mesajul warning: Cannot merge binary files: logo.png (HEAD vs. feature/design) îți spune că fișierul a fost modificat diferit în HEAD (branch-ul tău) și în feature/design, iar după el urmează CONFLICT (content) sau CONFLICT (add/add) pentru același fișier.
În folder rămâne versiunea ta (HEAD), fără markeri, dar fișierul e marcat ca nerezolvat. Tu decizi ce versiune rămâne: git checkout --ours logo.png păstrează versiunea ta, git checkout --theirs logo.png ia versiunea din branch-ul unit. Apoi git add și git commit.
De ce apare: cauzele frecvente
1Aceeași imagine schimbată pe două branch-uri
git merge feature/design
# CONFLICT în logo.png
git commit -m "Merge"git checkout --theirs logo.png
git add logo.png
git commit -m "Merge design"Alegi explicit versiunea care rămâne, apoi marchezi fișierul ca rezolvat.
2Ai încercat să editezi fișierul ca text
code logo.png # cauți markerii de conflictgit checkout --ours logo.png
git add logo.pngLa binare nu există markeri. Rezolvarea e alegerea unei versiuni întregi (sau o versiune nouă, făcută în editorul de imagini).
3Fișierul e generat
git add dist/app.zip # comis pe fiecare branchgit rm --cached dist/app.zip
echo "dist/" >> .gitignoreFișierele generate la build nu ar trebui versionate; dacă nu sunt în repository, nici nu pot intra în conflict.
Repară eroarea, direct în pagină
Ai unit feature/design în main, dar ambele branch-uri au schimbat logo.png, iar Git a afișat Cannot merge binary files și conflict pe fișier. Echipa a decis să rămână logo-ul din feature/design. Păstrează versiunea lui pentru logo.png și termină merge-ul cu mesajul Merge design.
Indiciu
Versiunea branch-ului unit se alege cu git checkout și opțiunea --theirs.
Reparația
Vezi conflictul:
git statusAlege versiunea din feature/design și termină merge-ul:
git checkout --theirs logo.png
git add logo.png
git commit -m "Merge design"Rezultat: logo.png are versiunea din feature/design, iar merge-ul e încheiat.
De ce merge
Git nu poate combina două versiuni ale unui fișier binar, așa că a lăsat alegerea în seama ta. git checkout --theirs logo.png pune în folder versiunea din feature/design, git add marchează conflictul ca rezolvat, iar git commit creează commit-ul de merge. Restul fișierelor din branch au fost unite automat.
Alte forme ale mesajului
warning: Cannot merge binary files: raport.pdf (HEAD vs. origin/main)warning: Cannot merge binary files: logo.png (HEAD vs. 3f2a1b4 (Logo nou))
Cum o eviți pe viitor
- Stabilește în echipă cine modifică fișierele binare comune (logo, documente), ca să nu le schimbe doi oameni în paralel.
- Nu comite fișiere generate (
dist/, arhive, exporturi): pune-le în.gitignore. - Pentru fișiere binare mari folosește Git LFS, care poate și bloca fișierele (
git lfs lock) cât lucrezi pe ele.
Întrebări frecvente
Ce înseamnă ours și theirs aici?
La git merge, --ours e branch-ul pe care ești (HEAD), iar --theirs e branch-ul pe care îl unești. La git rebase sensul se inversează: --ours e branch-ul pe care rebazezi.
Pot păstra ambele imagini?
Da, sub nume diferite: git show feature/design:logo.png > logo-nou.png salvează versiunea celuilalt branch alături. Apoi alegi una pentru logo.png și adaugi ambele fișiere.
Erori înrudite
CONFLICT (content): Merge conflict in pret.txt Ambele branch-uri au modificat aceleași linii din fișier, iar Git nu poate alege singur. Deschide fișierul, păstrează varianta corectă între marcajele <<<<<<<, ======= și >>>>>>>, șterge marcajele, apoi git add fișier și git commit. error: you need to resolve your current index first Ai un merge (sau rebase) oprit cu conflicte nerezolvate, iar Git nu te lasă să schimbi branch-ul până nu termini. Fie rezolvi conflictele (git add, apoi git commit), fie renunți la merge cu git merge --abort și abia apoi faci git switch. error: path 'pret.txt' is unmerged Fișierul e în conflict (merge, rebase, cherry-pick sau stash pop nerezolvat), iar git restore / git checkout -- nu știe ce versiune să pună. Alege explicit una (git checkout --ours sau --theirs fișier) sau editează fișierul, apoi git add fișier și termină operația. Î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.
