换行符检测器 (LF vs CRLF)

检测和转换 LF 和 CRLF 换行符

所有换行符检测和转换都在您的浏览器本地完成。

深度指南

换行符:LF、CRLF 与 CR,以及本检测器如何计数

LF、CRLF 和单独的 CR 是什么,为什么多出的回车会破坏脚本和差异比较,检测器究竟统计什么、看不到什么,以及命令行和 Git 的检查方法,输出均来自真实文件。

最后核实: 资料来源: The Open Group — POSIX definitions · IETF — RFC 4180 本指南的纯文本版

关键数字一览

LF (\n)
U+000A,Unix、Linux 和 macOS 文本文件使用
POSIX 把一行定义为若干非换行字符加一个结尾的换行符。
来源: The Open Group — POSIX definitions
CRLF (\r\n)
U+000D U+000A,Windows 的约定
RFC 4180 规定 CSV 记录之间使用 CRLF。
来源: IETF — RFC 4180
检测器统计什么
换行的个数,而不是行数
前面没有 CR 的 LF,以及 CRLF。单独的 CR 不计入。
文本框的行为
键入的文本读回来始终只有 LF
替换整个文本框内容的粘贴和转换按钮会保留 CRLF;之后再键入任何内容就会丢掉它。

修复在 Linux 上因 CRLF 而失败的脚本

用 Windows 换行符保存的 shell 脚本常常报出令人困惑的“找不到”错误。

  1. 步骤 1: 确认换行符

    运行 file script.sh,或把文本粘贴到这里点“分析换行符”。在输出中找 CRLF。

  2. 步骤 2: 转换为 LF

    点“转换为 LF (Unix)”,再用复制或下载;或在终端运行 sed -i 's/\r$//' script.sh。

  3. 步骤 3: 再检查第一行

    shebang 行必须以单独的 LF 结尾。用 cat -A script.sh 核对:$ 之前不应有 ^M。

  4. 步骤 4: 防止问题再次出现

    添加 .gitattributes 规则,如 *.sh text eol=lf,让 Git 在每次检出时都写入 LF。

三种换行符

名称 字符 常见来源
LF \n,U+000A Unix、Linux、macOS,大多数网页和源代码文件
CRLF \r\n,U+000D U+000A Windows 文本文件、许多网络协议,以及 RFC 4180 规定的 CSV
CR \r,U+000D 经典 Mac OS,现已罕见

POSIX 把行定义为“零个或多个非换行字符,加上一个结尾的换行符”。所以 wc -l 统计的是换行符,而不是看得见的行数:没有结尾换行的 one⏎two 报告 1,而 one⏎two⏎ 报告 2。“不完整行”指文件末尾没有结尾换行的文本。

检测器报告什么

粘贴文本并点分析换行符。它用正则表达式统计两样东西:前面没有 CR 的 LF,以及 CRLF 对。面板显示总行数(LF 加 CRLF,也就是换行的个数;如果文本没有结尾换行,就比行数少一)、LF 数量、CRLF 数量,以及结论:只有 LF、只有 CRLF,或混合(两者都有)。没有任何换行时显示“未检测到换行符”。

在真实页面上的核实结果:

粘贴的内容(替换整个文本框) 结果
one\r\ntwo\r\nthree\r\n 总数 3,LF 0,CRLF 3,“CRLF(Windows,回车加换行)”
one\ntwo\r\nthree\n 总数 3,LF 2,CRLF 1,“混合”
one\ntwo\nthree\n 总数 3,LF 3,CRLF 0,“LF(Unix/Linux/macOS,换行)”
a\rb\rc(只有 CR) “未检测到换行符”:单独的 CR 不计入

转换为 LF 会把 CRLF 和单独的 CR 都变成 LF。转换为 CRLF 先把一切规范成 LF,再写成 CRLF,所以混合文本会变得一致。复制和下载使用转换后的文本;下载的文件名是 text-with-line-endings.txt。

页面看不到什么

浏览器的文本框并不会原样保存你的字符。HTML 标准规定它的 value 读取结果是“规范化换行之后”的文本,也就是 CRLF 和 CR 读回来都是 LF。本页面只在两种情况下绕过了这一点:粘贴并替换文本框的全部内容,以及它自己的转换按钮产生的文本。这两种情况下,原始的 CR 字符会与文本框一起保存,并用于分析、复制和下载。

其余情况都只有 LF:

  • 你键入的文本,或粘贴到现有文本中间的内容,读回来只有 LF;所以即使粘贴的文本是 CRLF,也会被报告为 LF。
  • 粘贴或转换之后,只要再键入任何内容,CR 字符就没了,页面处理的是只有 LF 的文本。
  • 单独的 CR 从不计数,所以老式 Mac 风格的文件在转换之前会报告“未检测到换行符”。

对于磁盘上的文件,终端给出的答案才可靠。

检查真实文件

用 printf 创建的文件的输出:

文件内容 file 的说明 od -c 显示
one\ntwo\nthree\n ASCII text 每个单词后有 \n
one\r\ntwo\r\nthree\r\n ASCII text, with CRLF line terminators \r \n 成对
one\rtwo\rthree\r ASCII text, with CR line terminators 只有 \r
one\ntwo\r\nthree\n ASCII text, with CRLF, LF line terminators 两者都有

这四个文件的 wc -l 分别输出 3、3、0 和 3。只有 CR 的文件没有换行符,所以按行读取的工具会把它看成一整行。cat -A file 会在 CRLF 行的 $ 之前显示 ^M,grep -c $'\r' file 统计含 CR 的行数。在 Git 仓库中,git ls-files --eol 列出索引(i/)和工作区(w/)里记录的换行符:它输出了 i/lf、i/crlf、i/mixed,而对只有 CR 的文件输出 i/-text,因为 Git 不把它当作文本。

为什么重要

以 #!/bin/sh 加回车开头的脚本,会把解释器名写成 /bin/sh\r。在 bash 中直接运行时,它报错“cannot execute: required file not found”,而 sh script.sh 虽然能运行,但每一行末尾都带着一个多余的 CR。执行 sed -i 's/\r$//' script.sh 之后,同一个脚本就能运行并打印 hi。其他影响包括:某个编辑器重写了所有换行符导致整个文件出现差异、字符串比较失败,以及 \r 残留在 CSV 或配置值的最后一个字段里。

Git 与团队协作

Git 可以规范换行符,但前提是你告诉它。在 .gitattributes 中设置 text=auto,Git 会自行判断文件是否是文本,并在索引中把 CRLF 规范成 LF;eol=lf 或 eol=crlf 决定写入工作区的内容;两者都没有时,由 core.autocrlf 决定。常见的起步规则是 * text=auto,然后运行一次 git add --renormalize . 来转换现有文件。Git 文档完整描述了这一重新规范化的流程。

提示: 优先使用项目级的 .gitattributes,而不是每位开发者各自的 core.autocrlf,这样规则会随仓库一起流转。

常见错误

  • 把“总数”当成行数。它统计的是换行的个数。
  • 粘贴到现有文本中间,却相信对 CRLF 输入给出的“LF”结论。
  • 转换为 CRLF 之后又去编辑再下载;键入会丢掉 CR。
  • 转换二进制文件,它们可能合理地包含看起来像 CR 或 LF 的字节。
  • 忘了结尾的换行:POSIX 工具把末尾没有结束符的文本视为不完整行。

相关工具

用隐藏字符清理器找出其他不可见字符,用文本对比比较两个版本,或用文本转十六进制查看字符串的字节。

常见问题

LF 和 CRLF 换行符有什么区别?

LF(换行符)是 Unix、Linux 和 macOS 系统用于换行符的单个字符(\n,ASCII 10)。CRLF(回车符 + 换行符)是 Windows 和 DOS 系统使用的两字符序列(\r\n,ASCII 13 + 10)。这种差异源于历史打字机和电传打字机制,其中回车将打印头移到行首,换行将纸张前进到下一行。现代操作系统为了向后兼容而保留这些约定。

为什么换行符在编程和文本文件中很重要?

换行符很重要,因为不正确的格式可能导致多个问题:shell 脚本可能无法执行,版本控制系统可能在仅换行符不同时将文件显示为已更改,文本编辑器可能错误显示文件,编译器可能产生错误,跨平台协作可能变得有问题。一致的换行符确保在不同系统和工具之间的可靠行为。

如何检测文件使用什么换行符?

将文件内容粘贴到此工具中并点击"分析换行符"。工具将显示详细统计信息,包括 LF 行数、CRLF 行数、是否有混合换行符以及主要格式。您还可以使用文本编辑器如 VS Code(在状态栏中显示"LF"或"CRLF")、Notepad++(查看 → 显示符号 → 显示行尾)或 Unix 系统上的命令行工具如"file"。

我应该为我的项目使用 LF 还是 CRLF?

对于大多数现代开发,即使在 Windows 上也建议使用 LF(Unix 风格),因为大多数开发工具都支持它。对源代码、shell 脚本、配置文件和一般文本文件使用 LF。仅对 Windows 上特别需要的文件使用 CRLF(如 .bat 或 .cmd 文件)。最重要的方面是一致性 - 选择一种格式并在整个项目中使用它。

什么是混合换行符,为什么它们有问题?

混合换行符发生在单个文件同时包含 LF 和 CRLF 换行符时。这通常发生在多人使用不同设置的不同文本编辑器编辑文件时,或者从不同来源复制和粘贴代码时。混合换行符可能导致不可预测的行为,使差异难以阅读,触发 lint 错误,并导致脚本失败。始终标准化为单一换行符格式。

如何在 Git 中修复换行符问题?

通过在存储库中创建带有"* text=auto"的 .gitattributes 文件来配置 Git 自动处理换行符。这告诉 Git 在存储库中将换行符规范化为 LF,并在检出时转换为适合平台的格式。您还可以使用"git config --global core.autocrlf"(在 Windows 上设置为"true",在 Mac/Linux 上设置为"input")。对于具有错误换行符的现有文件,使用此工具转换它们,然后提交更改。

错误的换行符会破坏我的 shell 脚本吗?

是的,具有 CRLF 换行符的 shell 脚本通常会在 Unix/Linux 系统上无法执行。shell 解释器将回车符(\r)视为命令的一部分,导致诸如"command not found"或"bad interpreter"之类的错误。如果在 Windows 上编辑 shell 脚本,在将它们部署到 Unix/Linux 服务器之前,始终确保它们使用 LF 换行符。此工具可以即时将 CRLF 转换为 LF。

如何防止团队中的换行符问题?

建立团队约定(通常是现代开发的 LF),创建 .gitattributes 文件来强制执行它,配置 IDE/编辑器使用一致的换行符,在 CI/CD 管道中添加换行符检查,在项目 README 中记录标准,并使用预提交钩子在提交之前验证换行符。此工具可以帮助团队成员在推送代码之前验证和修复换行符。

此工具会将我的文本发送到服务器吗?

不会,所有换行符检测和转换完全在您的 Web 浏览器中使用 JavaScript 进行。您的文本永远不会离开您的设备或发送到任何服务器。这使得该工具完全安全,可用于分析敏感代码、配置文件或专有脚本。初始页面加载后,工具可离线工作。

LF 和 CRLF 之间的文件大小差异是多少?

CRLF 换行符每个换行符使用两个字节(\r\n),而 LF 仅使用一个字节(\n)。对于具有多行的文件,这可能导致明显的大小差异。例如,具有 1,000 行的文件使用 CRLF 将比使用 LF 大约 1KB。虽然通常对源代码不重要,但对于非常大的文件或优化带宽和存储时很重要。

我可以使用此工具处理大文件吗?

是的,此工具可以处理任何大小的文本文件,因为所有处理都在您的浏览器中本地完成。但是,非常大的文件(几兆字节或更多)可能需要一些时间来处理,具体取决于您的计算机性能。对于非常大的文件,您可能想使用为批处理优化的命令行工具,如 dos2unix 或 unix2dos。

换行符如何影响 Docker 容器?

构建 Docker 容器时,shell 脚本和配置文件必须使用 LF(Unix)换行符,即使您在 Windows 上开发也是如此。如果将带有 CRLF 换行符的 shell 脚本复制到 Linux 容器中,脚本将无法执行。在构建容器镜像之前,始终验证 Dockerfile、shell 脚本和配置文件使用 LF。此工具可以快速将 Windows 编辑的文件转换为 Unix 格式。

资料来源

  1. The Open Group — POSIX.1-2017 Base Definitions, chapter 3 — Definitions of Line (3.206), Incomplete Line (3.195) and Newline Character (3.243).
  2. IETF — RFC 4180, Common Format and MIME Type for CSV Files
  3. Git documentation — gitattributes — text, eol and text=auto; core.autocrlf.
  4. WHATWG HTML Standard — The textarea element — The value getter returns the API value, with newlines normalised to LF.

本指南用浅白语言解释已公布的规则,不构成财务、法律或官方意见。政策会变动,做决定前请向上方链接的政府机构核实。

把这个工具嵌入你的网站

免费使用。把这段代码贴到你的网页,并保留指向 ToolSG 的链接。