Git LinuxWindowsmacOS

Git: warning: LF will be replaced by CRLF

  • Обновлено
  • Чтение ≈ 1 минута

Краткий ответ

Предупреждение связано с core.autocrlf на Windows. Настройте autocrlf и .gitattributes для единообразия переводов строк.

В этой статье
  1. Что означает ошибка
  2. Причины и признаки
  3. Пошаговое решение
  4. Если проблема осталась

#Что означает ошибка

Сообщение
LF will be replaced by CRLF

Предупреждение связано с core.autocrlf на Windows. Настройте autocrlf и .gitattributes для единообразия переводов строк.

#Причины и признаки

Возможная причинаКак узнатьЧто делать
autocrlf=truecore.autocrlf преобразует окончания строк.Сверьте локальную настройку и политику проекта.
Нет .gitattributesНет согласованных правил файлов репозитория.Добавьте адресные записи .gitattributes.
Смешанные окончанияРазные файлы имеют непоследовательные окончания.Согласуйте формат с командой до нормализации.
Скрипты с CRLFShell-скрипт сохранён в CRLF.Используйте для него eol=lf и проверьте запуск.

#Пошаговое решение

  1. Проверьте смысл предупрежденияLF will be replaced by CRLF обычно предупреждает о преобразовании окончаний строк Git, а не о повреждении файла. В терминале репозитория выполните git status и git config --show-origin --get core.autocrlf, чтобы узнать источник настройки.
  2. Посмотрите реальные окончания строкВ VS Code откройте файл и посмотрите индикатор LF или CRLF справа в строке состояния. Для программных скриптов и конфигураций проекта согласуйте единый формат с командой; менять наугад сотни файлов нельзя, особенно если подписи или проверки зависят от байтового содержимого.
  3. Настройте правила проекта явноЕсли репозиторий требует LF, добавьте проверенное правило .gitattributes, например *.sh text eol=lf для shell-скриптов; для других типов используйте принятые проектом правила. Не переключайте core.autocrlf всем пользователям как универсальное решение. Перед перенормализацией сохраните несохранённые изменения.
  4. Проверьте изменения перед коммитомИспользуйте git diff --check и git diff --stat. Если Git показывает изменения во всём файле только из-за строк, отмените массовую нормализацию и обсудите правила. Успех — предсказуемые окончания строк и отсутствие ненужных изменений в коммите.

#Если проблема осталась

Если «Git: warning: LF will be replaced by CRLF» повторяется, сохраните время, состояние подключения и точный текст ошибки. Не меняйте сразу несколько настроек — иначе станет трудно понять, какое действие повлияло на результат.

Так эту ошибку тоже называют

Источники и обновления

Последнее обновление статьи: 2 ноября 2026. Версии программ и интерфейсы меняются — если шаги не совпадают с вашей версией, сверяйтесь с документацией производителя.