Git “LF will be replaced by CRLF” uyarısı, bir dosyanın satır sonlarının çalışma kopyasında başka bir biçime dönüştürülebileceğini bildirir. Tek başına bir hata anlamına gelmez; Git, dosyanın içeriğini kaybettiğini değil, LF ve CRLF arasındaki satır sonu dönüşümünü haber verir.
Uyarının nedenini anlamak için dosyanın hangi satır sonu biçimini kullandığına ve Git’in core.autocrlf ayarına bakmalısın. Depoda yer alan .gitattributes dosyası da bu dönüşüm politikasını etkileyebilir.
LF will be replaced by CRLF uyarısı ne anlatır?
Bu mesaj, Git’in çalışma kopyasındaki bir dosyayı ileride LF yerine CRLF satır sonlarıyla yazabileceğini anlatır. Git’in satır sonu dönüşüm mantığı, resmî gitattributes belgelerinde dosyanın depoya eklenirken ve çalışma dizinine aktarılırken farklı biçimlerde tutulabileceği açıklanır.
Windows kullanan bir üniversite öğrencisinin Linux üzerinde oluşturulmuş bir depoyu klonladığını düşünelim. Depoda hesapla.py dosyası LF satır sonlarıyla kayıtlı olabilir. Öğrenci dosyada küçük bir değişiklik yaptıktan sonra şu komutu çalıştırır:
git add hesapla.py
Git’in Windows ortamında CRLF kullanacak şekilde yapılandırıldığı durumda terminalde şu uyarı görülebilir:
warning: in the working copy of 'hesapla.py', LF will be replaced by CRLF the next time Git touches it
Buradaki working copy ifadesi, bilgisayarındaki çalışma kopyasını belirtir. Mesaj, dosyanın depoya eklenmesinin başarısız olduğunu söylemez. Git, metin dosyasını depoda belirlediği satır sonu biçimine göre değerlendirebilir ve çalışma kopyasının ileride CRLF olarak yeniden oluşturulabileceğini bildirir.
Karşına bunun daha kısa bir biçimi de çıkabilir:
LF will be replaced by CRLF the next time Git touches it
Kısa ifade yalnızca dönüşümü ve zamanlamayı söyler. in the working copy of 'hesapla.py' bölümü bulunan ayrıntılı ifade ise hangi dosyanın etkilendiğini açıkça gösterir. Her iki mesajın temel anlamı aynıdır: Git, dosyaya sonraki işlemlerden birinde satır sonu dönüşümü uygulayabilir.
Uyarıdan sonra ilk kontrol edilecek ayar, Git’in hangi satır sonu politikasını kullandığıdır:
git config --show-origin --get core.autocrlf
Çıktıda true görülmesi, Windows çalışma kopyasında CRLF kullanılmasını isteyen bir yapılandırmaya işaret eder. Değerin ne anlama geldiği, input ve false seçeneklerinden nasıl ayrıldığı sonraki bölümde ele alınmalıdır. Uyarıyı gördüğünde dosyayı hemen silmek, yeniden oluşturmak veya bütün depoyu baştan klonlamak gerekmez.
LF ve CRLF arasındaki fark nedir?

LF, satır sonunu temsil eden tek bir kontrol karakteridir. CRLF ise carriage return ve line feed karakterlerinin birlikte kullanıldığı iki karakterli bir satır sonu dizisidir. Bu farkı görünür bir gösterimle şöyle düşünebilirsin:
LF: "Merhaban"
CRLF: "Merhabarn"
Buradaki n ve rn gösterimleri, dosyada çoğu metin düzenleyicisinde görünmeyen karakterleri anlatmak için kullanılır. Unix ve Linux tabanlı sistemlerde LF, Windows ortamında ise çoğunlukla CRLF kullanılır. Bu nedenle aynı Python dosyası iki sistemde açıldığında ekranda aynı satırları gösterebilir, fakat satırların sonunda farklı karakter dizileri bulunabilir.
Satır sonu farkı genellikle Python kodunun, değişken adlarının veya metnin kendisinin değiştiği anlamına gelmez. Fark, satırların nerede bittiğini belirten görünmeyen karakterlerdedir. Git bu karakterleri karşılaştırabildiği için, içerik aynı görünse bile dosyada satır sonu dönüşümü hakkında uyarı verebilir.
core.autocrlf true, input ve false nasıl çalışır?
core.autocrlf ayarı, Git'in metin dosyalarında satır sonlarını çalışma kopyası ile depo arasında nasıl dönüştüreceğini belirler. Linux'ta hazırlanmış bir depoyu Windows'ta klonlayan öğrencinin dosyaları CRLF olarak görmesi, Git'in true ayarıyla çalışma kopyasında yaptığı dönüşümden kaynaklanabilir.
| ayar | çalışma kopyası | depoya ekleme davranışı | değerlendirme notu |
|---|---|---|---|
true |
Depodaki LF satır sonlarını çalışma kopyasında CRLF biçimine dönüştürür. | Metin dosyalarındaki CRLF satır sonlarını dizine alınırken LF biçiminde normalleştirir. | Windows çalışma ortamında CRLF ile çalışmak isteyen projelerde kullanılabilir. Takımın depo politikasını tek başına belirlemez. |
input |
Checkout sırasında LF satır sonlarını otomatik olarak CRLF biçimine dönüştürmez. | CRLF satır sonlarını dosya dizine alınırken LF biçimine çevirir. | Çalışma kopyasında LF kullanıp depoya giren metinleri LF olarak tutmak isteyen ortamlarda uygundur. |
false |
Otomatik satır sonu dönüşümü yapmaz. | Git, CRLF ve LF arasında otomatik normalleştirme uygulamaz. | Dosyaların satır sonlarını proje içindeki başka kuralların belirlediği durumlarda düşünülebilir. |
Bu değerleri işletim sistemine göre otomatik seçmek yerine, projenin hangi satır sonu politikasını benimsediğine göre değerlendirmek gerekir. true seçildiğinde Windows'taki çalışma kopyası rahat görünse de ekipteki diğer kişilerin farklı ayarları varsa depo içindeki kuralı ayrıca tanımlamak daha tutarlı bir yaklaşım sağlar. Ayrıntılar için Git yapılandırma belgelerine bakabilirsin.
git config --get core.autocrlf
git config --show-origin --show-scope --get core.autocrlf
İlk komut, etkin değeri true, input veya false olarak gösterir. Ayar tanımlı değilse sonuç alınmayabilir. İkinci komut, değerin hangi yapılandırma kaynağından ve hangi kapsamdan geldiğini gösterir. --local yalnızca mevcut deponun .git/config dosyasını, --global ise kullanıcıya ait Git yapılandırmasını okur. Bir depo içindeki yerel ayar, genel kullanıcı ayarının önüne geçebilir.
.gitattributes satır sonlarını takım için nasıl sabitler?

.gitattributes dosyası, satır sonu kurallarını kişisel Git ayarlarından çıkarıp depo içinde tanımlamana yardımcı olur. Dosya depoya eklendiği için ekipteki herkes aynı kuralları görebilir.
* text=auto
Bu kural, Git'in dosyaları metin veya ikili dosya olarak değerlendirmesine yardımcı olur. Metin olarak tanınan dosyalar için depo içindeki satır sonları LF biçiminde normalleştirilebilir. Görseller ve diğer ikili dosyalar içinse dosya türüne uygun açık kurallar eklemek gerekebilir.
Linux ortamında çalıştırılacak kabuk betiklerinin çalışma kopyasında LF kullanması isteniyorsa ilgili dosya kalıbı ayrıca yazılabilir:
*.sh text eol=lf
Burada *.sh kalıbı kabuk betiklerini eşleştirir, text dosyanın metin olarak işlenmesini sağlar ve eol=lf checkout sırasında çalışma kopyasında LF kullanılmasını belirtir. Kalıplar dosya yollarına göre uygulanır. .gitattributes dosyasının sözdizimi ve satır sonu davranışları için Git attributes belgelerini inceleyebilirsin.
git add --renormalize mevcut depoda nasıl kullanılır?
.gitattributes dosyasını ekledikten sonra git add --renormalize . komutu, izlenen dosyaları yeni satır sonu kurallarına göre yeniden değerlendirir ve gerekli değişiklikleri aşamalandırır. Bu işlem dosyaları silmez ve depoyu yeniden klonlamayı gerektirmez.
Örneğin Linux'ta oluşturulmuş bir depoyu Windows bilgisayarında klonlayan öğrencinin kök dizinde şu kuralları tanımladığını düşünelim:
* text=auto
*.sh text eol=lf
Bu kurallar, Git'in metin dosyalarını uygun biçimde işaretlemesine ve shell betiklerinin çalışma kopyasında LF satır sonlarını korumasına yardımcı olur. Ardından şu adımlar izlenebilir:
.gitattributesdosyasını oluştur ve dosyayıgit add .gitattributeskomutuyla aşamalandır.git add --renormalize .komutunu çalıştır.git statusile hangi dosyaların değişmiş göründüğünü kontrol et.git diff --cachedkomutuyla aşamalandırılmış farkları incele.- Yalnızca satır sonu düzenlemesi beklenen dosyalar varsa sonucu açıklayan bir commit oluştur.
git add .gitattributes
git add --renormalize .
git status
git diff --cached
git commit -m "Normalize line endings"
Beklenen sonuç: Git, satır sonu kuralından etkilenen izlenen dosyaları aşamalandırır. İçerikteki gerçek değişiklikleri ayrıca kontrol edebilmen için git diff --cached çıktısını incelemek önemlidir.
--renormalize seçeneği, Git'in temizleme sürecini izlenen dosyalara yeniden uygulayarak dizindeki kayıtları güncellemek için kullanılır ve -u davranışını içerir. Komuttaki nokta, geçerli dizin ve altındaki yolları hedefleyen pathspec olarak çalışır. Ayrıntılar için Git add belgelerine bakabilirsin.
Bu uyarıyı yönetirken hangi hatalardan kaçınmalısın?
“LF will be replaced by CRLF” uyarısını hata sanıp depoyu silmek veya yeniden klonlamak satır sonu politikasını çözmez. Sorun, Git'in dosyaları hangi kurala göre aşamalandırıp çalışma kopyasına çıkaracağının belirlenmesiyle ilgilidir.
Aynı depoda çalışan kişilerin farklı core.autocrlf ayarları kullanması, dosyalarda gerçek kod değişikliği olmadan çalışma kopyasında farklılıklar oluşmasına yol açabilir. Projenin satır sonu politikasını .gitattributes içinde açıkça yazmak, kişisel Git ayarlarının oluşturduğu belirsizliği azaltır.
Shell betiklerinde bu konu daha kritik olabilir. Bir .sh dosyası CRLF ile kaydedildiğinde Linux'taki kabuk, satır sonundaki taşıma dönüşü karakterini komutun parçası gibi değerlendirebilir. Bunun sonucunda betik doğru yorumlanmayabilir veya çalıştırma sırasında hata verebilir. Git'in satır sonu ve öznitelik belgeleri bu tür dosyalar için uygun eol kuralının açıkça tanımlanabileceğini belirtir.
- Uyarının hata mı, yoksa satır sonu dönüşümü hakkında bilgilendirme mi olduğunu ayır.
- Geçerli
core.autocrlfayarınıgit config --get core.autocrlfile kontrol et. .gitattributesiçindekitextveeolkurallarını incele.- Renormalizasyon sonrasında oluşan aşamalandırılmış farkları gözden geçir.
- Shell betiklerinin ve benzeri platforma duyarlı dosyaların satır sonlarını ayrıca doğrula.
Sık Sorulan Sorular
LF will be replaced by CRLF uyarısı bir hata mıdır?
LF will be replaced by CRLF uyarısı çoğu durumda bir hata değil, Git'in dosyayı çalışma kopyasına hangi satır sonuyla yazacağını bildiren bir uyarıdır. Yine de özellikle shell betikleri gibi platforma duyarlı dosyalarda proje kurallarını kontrol etmek gerekir.
core.autocrlf için true, input ve false seçeneklerinden hangisi kullanılmalıdır?
Uygun seçenek, işletim sistemi, takımın çalışma biçimi ve depodaki .gitattributes kuralları birlikte değerlendirilerek seçilmelidir. Windows çalışma kopyasında CRLF kullanmak isteyenler true, LF dönüşümünü yalnızca commit aşamasında yapmak isteyenler input, otomatik dönüşüm istemeyenler ise false seçeneğini değerlendirebilir.
.gitattributes ekledikten sonra git add --renormalize . ne yapar?
git add --renormalize ., geçerli dizin ve altındaki izlenen dosyaları yeni öznitelik kurallarına göre yeniden temizleyerek indekse alır. Dosyaları silmez, yeni bir klon oluşturmaz ve untracked dosyaları toplamak için kullanılmaz.
Shell betikleri CRLF satır sonlarıyla kaydedilirse Linux'ta neden sorun çıkabilir?
Shell betikleri CRLF satır sonlarıyla kaydedildiğinde Linux kabuğu satır sonunda kalan CR karakterini komutun veya yorumlayıcı yolunun parçası gibi okuyabilir. Bu durum betiğin yorumlanmasını ya da çalıştırılmasını engelleyebilir.
Satır sonu uyarısını doğru yönetmek için Git ayarlarını, .gitattributes kurallarını ve renormalizasyon farklarını birlikte kontrol etmek yeterli bir başlangıç sağlar.