...
Eroare Git · Configurare, comenzi și mediul de lucru

warning: in the working copy of 'index.html', LF will be replaced by CRLF the next time Git touches it

Pe scurt

E un avertisment, nu o eroare: Git convertește sfârșiturile de linie (LF pe Linux/macOS, CRLF pe Windows) din cauza setării core.autocrlf. Ca echipa să nu mai depindă de setările fiecăruia, adaugă un fișier .gitattributes cu * text=auto eol=lf și fă commit.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Fiecare linie dintr-un fișier text se termină cu un caracter invizibil: LF (\n) pe Linux și macOS, CRLF (\r\n) pe Windows. Cu core.autocrlf=true (setarea implicită din Git for Windows), Git păstrează în repository LF, dar scrie fișierele pe disc cu CRLF. Mesajul îți spune că index.html are acum LF și că, data viitoare când Git îl scrie pe disc (checkout, merge), va primi CRLF. Conținutul nu se strică.

Problemele apar în echipele mixte: diff-uri în care „se schimbă” toate liniile, scripturi .sh care nu mai rulează pe Linux din cauza \r. Soluția stabilă este .gitattributes în repository, care spune pentru toată lumea cum se tratează fișierele, indiferent de core.autocrlf de pe fiecare calculator. Varianta inversă a mesajului (CRLF will be replaced by LF) apare pe Linux/macOS cu core.autocrlf=input.

De ce apare: cauzele frecvente

1Echipă mixtă Windows / Linux fără reguli comune

Greșit
BASH
git add index.html
# warning: LF will be replaced by CRLF
Corect
BASH
echo "* text=auto eol=lf" > .gitattributes
git add .gitattributes
git commit -m "Normalizez sfârșitul de linie"

.gitattributes e salvat în repository, deci aceeași regulă se aplică pe orice calculator.

2Scripturi shell cu CRLF

Greșit
BASH
./deploy.sh
# /bin/bash^M: bad interpreter
Corect
BASH
echo "*.sh text eol=lf" >> .gitattributes
git add --renormalize .

Scripturile trebuie să aibă LF ca să ruleze pe Linux. --renormalize aplică regula și fișierelor deja urmărite.

Repară tu

Repară eroarea, direct în pagină

Colegii de pe Windows primesc la fiecare git add avertismentul warning: in the working copy of 'index.html', LF will be replaced by CRLF the next time Git touches it, iar diff-urile arată linii schimbate fără motiv. Adaugă în proiect fișierul .gitattributes cu regula * text=auto eol=lf și salvează-l într-un commit.

Indiciu

Regula trebuie să fie în repository, ca să se aplice pe toate calculatoarele.

Alte forme ale mesajului

  • warning: LF will be replaced by CRLF in index.html. The file will have its original line endings in your working directory
  • warning: in the working copy of 'deploy.sh', CRLF will be replaced by LF the next time Git touches it
  • warning: CRLF will be replaced by LF in deploy.sh.

Cum o eviți pe viitor

  • Pune un .gitattributes în fiecare proiect nou: * text=auto eol=lf, plus excepții (de exemplu *.bat text eol=crlf, *.png binary).
  • Setează editorul să salveze cu LF (în VS Code, files.eol).
  • După ce adaugi .gitattributes într-un proiect existent, rulează git add --renormalize . și fă un commit separat.

Întrebări frecvente

Pot doar să ascund avertismentul?

Poți seta git config --global core.safecrlf false, dar asta ascunde doar mesajul. Regulile din .gitattributes rezolvă cauza pentru toată echipa.

Ce valoare de core.autocrlf să folosesc?

Pe Windows, true (implicit); pe Linux și macOS, input sau nesetat. Cu un .gitattributes bun în proiect, valoarea contează mult mai puțin.

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.