...
Eroare Git · Branch-uri, merge și conflicte

warning: Cannot merge binary files: logo.png (HEAD vs. feature/design)

Pe scurt

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

Greșit
BASH
git merge feature/design
# CONFLICT în logo.png
git commit -m "Merge"
Corect
BASH
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

Greșit
BASH
code logo.png   # cauți markerii de conflict
Corect
BASH
git checkout --ours logo.png
git add logo.png

La binare nu există markeri. Rezolvarea e alegerea unei versiuni întregi (sau o versiune nouă, făcută în editorul de imagini).

3Fișierul e generat

Greșit
BASH
git add dist/app.zip   # comis pe fiecare branch
Corect
BASH
git rm --cached dist/app.zip
echo "dist/" >> .gitignore

Fișierele generate la build nu ar trebui versionate; dacă nu sunt în repository, nici nu pot intra în conflict.

Repară tu

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.

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

← Toate erorile Git

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.