换行符检测器 (LF vs CRLF)
检测和转换 LF 和 CRLF 换行符
所有换行符检测和转换都在您的浏览器本地完成。
深度指南
换行符:LF、CRLF 与 CR,以及本检测器如何计数
LF、CRLF 和单独的 CR 是什么,为什么多出的回车会破坏脚本和差异比较,检测器究竟统计什么、看不到什么,以及命令行和 Git 的检查方法,输出均来自真实文件。
关键数字一览
- LF (\n)
- U+000A,Unix、Linux 和 macOS 文本文件使用
- POSIX 把一行定义为若干非换行字符加一个结尾的换行符。
- 来源: The Open Group — POSIX definitions
- 检测器统计什么
- 换行的个数,而不是行数
- 前面没有 CR 的 LF,以及 CRLF。单独的 CR 不计入。
- 文本框的行为
- 键入的文本读回来始终只有 LF
- 替换整个文本框内容的粘贴和转换按钮会保留 CRLF;之后再键入任何内容就会丢掉它。
修复在 Linux 上因 CRLF 而失败的脚本
用 Windows 换行符保存的 shell 脚本常常报出令人困惑的“找不到”错误。
-
步骤 1: 确认换行符
运行 file script.sh,或把文本粘贴到这里点“分析换行符”。在输出中找 CRLF。
-
步骤 2: 转换为 LF
点“转换为 LF (Unix)”,再用复制或下载;或在终端运行 sed -i 's/\r$//' script.sh。
-
步骤 3: 再检查第一行
shebang 行必须以单独的 LF 结尾。用 cat -A script.sh 核对:$ 之前不应有 ^M。
-
步骤 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 格式。
资料来源
- The Open Group — POSIX.1-2017 Base Definitions, chapter 3 — Definitions of Line (3.206), Incomplete Line (3.195) and Newline Character (3.243).
- IETF — RFC 4180, Common Format and MIME Type for CSV Files
- Git documentation — gitattributes — text, eol and text=auto; core.autocrlf.
- WHATWG HTML Standard — The textarea element — The value getter returns the API value, with newlines normalised to LF.
本指南用浅白语言解释已公布的规则,不构成财务、法律或官方意见。政策会变动,做决定前请向上方链接的政府机构核实。
把这个工具嵌入你的网站
免费使用。把这段代码贴到你的网页,并保留指向 ToolSG 的链接。