warning: in the working copy of 'index.html', LF will be replaced by CRLF the next time Git touches it
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
git add index.html
# warning: LF will be replaced by CRLFecho "* 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
./deploy.sh
# /bin/bash^M: bad interpreterecho "*.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ă 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.
Reparația
Creează regula și salveaz-o:
echo "* text=auto eol=lf" > .gitattributes
cat .gitattributes
git add .gitattributes
git commit -m "Normalizez sfârșitul de linie"Rezultat: commit-ul conține .gitattributes cu * text=auto eol=lf. Într-un proiect real, rulezi apoi git add --renormalize . și faci un commit separat.
De ce merge
Avertismentul venea din conversia automată făcută de core.autocrlf, o setare diferită pe fiecare calculator. .gitattributes e un fișier al proiectului: text=auto îi spune lui Git să detecteze fișierele text, iar eol=lf să le scrie mereu cu LF. Fiind salvat într-un commit, regula ajunge la toți colegii la următorul pull, indiferent de setările lor.
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 directorywarning: in the working copy of 'deploy.sh', CRLF will be replaced by LF the next time Git touches itwarning: 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
no changes added to commit (use "git add" and/or "git commit -a") Ai modificat fișiere urmărite, dar nu le-ai pus în staging, deci commit-ul nu are ce salva. Rulează git add fișier (sau git commit -am "mesaj" pentru toate fișierele urmărite), apoi commit. The following paths are ignored by one of your .gitignore files Fișierul pe care vrei să-l adaugi se potrivește cu o regulă din .gitignore, deci Git refuză să-l pună în staging. Dacă fișierul trebuie de fapt urmărit, scoate sau corectează regula din .gitignore; dacă e o excepție, folosește git add -f fișier. fatal: detected dubious ownership in repository at '/home/elev/proiect' Folderul repository-ului aparține altui utilizator decât cel cu care rulezi Git, iar Git refuză să lucreze în el din motive de securitate. Dacă ai încredere în folder, adaugă-l ca sigur: git config --global --add safe.directory /home/elev/proiect. Î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.
