Открыть сервисСервис

Перевод текстовых файлов из LF в CRLF

Перевод текстовых файлов из LF в CRLF — это преобразование окончания строк в текстовом файле с формата Unix (LF, символ \n, 0x0A) на формат Windows (CRLF, последовательность \r\n, 0x0D 0x0A). Операция выполняется при переносе файлов между разными операционными системами, настройке версионного контроля или подготовке файлов для программ, рассчитанных на Windows-соглашения.

Причины конфликта окончаний строк

В разных ОС исторически сложились разные символы для обозначения конца строки:

ОС / форматОбозначениеКоды (hex)
Unix, Linux, macOSLF (\n)0x0A
Windows, MS-DOSCRLF (\r\n)0x0D 0x0A
старый Mac OS (до Mac OS X)CR (\r)0x0D

Современные редакторы (VS Code, Notepad++, Sublime Text) обычно отображают оба варианта корректно, но некоторые программы — например, устаревшие версии Блокнота в Windows, ряд встроенных парсеров, скриптовые интерпретаторы — могут некорректно обрабатывать «чужие» окончания. В частности, Bash-скрипты с CRLF-окончаниями в Linux вызывают ошибку вида $'\r': command not found.

Способы перевода LF → CRLF

В Windows PowerShell

Самый быстрый способ для одного файла:

``powershell (Get-Content file.txt) -replace "n","rn" | Set-Content file.txt ```

Для пакетной обработки всех файлов в каталоге:

``powershell Get-ChildItem *.txt | ForEach-Object { $c = Get-Content $_.FullName -Raw $c = $c -replace "rn","n" -replace "n","rn" Set-Content $_.FullName $c -NoNewline } ``

В Windows Command Prompt

С помощью утилиты unix2dos (из пакета GnuWin32 или Git for Windows):

``cmd unix2dos file.txt ``

В Linux / macOS

Утилита todos или unix2dos (устанавливаются из репозиториев дистрибутива):

``bash sudo apt install todos # Debian/Ubuntu todos file.txt ``

Альтернатива без установки пакетов — sed:

``bash sed -i 's/$/\r/' file.txt ``

Для обработки всех файлов в директории:

``bash find . -type f -name "*.txt" -exec sed -i 's/$/\r/' {} \; ``

В текстовых редакторах

  • Notepad++ (Windows): меню «Перенос строк» («Encoding» → «EOL Conversion») → «Windows (CR LF)».
  • VS Code: строка состояния внизу справа показывает текущий тип окончания (LF или CRLF); клик по ней открывает список, где можно выбрать CRLF. Для постоянного значения — настройка files.eol в settings.json: "files.eol": "\r\n".
  • Sublime Text: View → Line Endings → Windows.

В Git

Git по умолчанию хранит в репозитории окончания LF, а при чекауте преобразует их под целевую ОС. Чтобы принудительно сохранять CRLF в рабочей копии:

``bash git config --global core.autocrlf true ``

Значение true означает: при коммите CRLF → LF, при чекауте LF → CRLF. Значение input сохраняет LF в репозитории, но не преобразует при чекауте. Дополнительно можно добавить в .gitattributes:

`` *.txt text eol=crlf ``

Это гарантирует, что указанные файлы всегда будут с CRLF в рабочей директории.

В Python

``python with open("file.txt", "rb") as f: data = f.read() data = data.replace(b"\n", b"\r\n") with open("file.txt", "wb") as f: f.write(data) ``

Перед заменой рекомендуется нормализовать файл, убрав все \r, чтобы не получить \r\r\n.

Проверка результата

Для визуальной проверки в Linux:

``bash cat -A file.txt ``

Конец строки с CRLF отобразится как ^M$ (где ^M — это \r). В Windows PowerShell:

``powershell Get-Content file.txt -Encoding Byte | Select-Object -First 50 ``

Или проще — открыть файл в любом редакторе с отображением служебных символов.

Типичные сценарии применения

  • Подготовка файлов .bat и .cmd для Windows: интерпретатор cmd.exe корректно выполняет скрипты только с CRLF.
  • Настройка репозиториев с участием разработчиков на разных ОС.
  • Передача текстовых данных в программы, чувствительные к формату строк (некоторые ERP-системы, парсеры CSV).
  • Исправление ошибок в CI/CD-пайплайнах, где Linux-раннеры получают файлы с CRLF.

Источники:

  • «Pro Git», Scott Chacon, Ben Straub — раздел о работе с окончаниями строк
  • Документация Microsoft Learn: PowerShell about_Line_continuation и about_Windows_PowerShell
  • Документация Git: git-config, раздел core.autocrlf
  • Руководства Notepad++ и Visual Studio Code по настройке окончаний строк
Заметили ошибку или не согласны с информацией в статье? Напишите нам support@bfometr.ru