代码术语:lf_crlf

LF 与 CRLF

LF 和 CRLF 是文本文件里表示「换行」的两种字节约定,围绕它们产生的跨平台问题,几乎是每个开发者都会踩一次的老坑。

  • CR(Carriage Return,回车)= ASCII 13 / 0x0D,写作 \r:老式打字机上把字车(carriage)推回行首。
  • LF(Line Feed,换行)= ASCII 10 / 0x0A,写作 \n:把滚筒转动一行,也就是进纸一行。

打字机上这是两个独立动作,要换到下一行行首,得先回车、再换行。这个历史包袱留在了计算机里,不同系统各取了其中一部分。

名称 字节 主要使用者
LF 0A,即 \n Unix / Linux、macOS(OS X 起)、现代网络协议与绝大多数开发工具
CRLF 0D 0A,即 \r\n Windows / DOS、HTTP 头、SMTP、多数 Windows 文本文件
CR 0D,即 \r 经典 Mac OS(OS 9 及以前),现在基本绝迹

注意 CRLF 是两个字节,所以同样是「3 行文本」,Windows 文件会比 Linux 文件多 3 个字节——这是文件大小和校验和差异的常见来源。

  • 跨平台脚本报错:在 Windows 上编辑的 #!/bin/bash 脚本拷到 Linux,报 bad interpreter: /bin/bash^M,因为内核把 \r 也当成了解释器路径的一部分。
  • Git 自动转换:core.autocrlf=true(Windows)会在 checkout 时把 LF 转成 CRLF、提交时再转回 LF,团队协作时容易产生整文件「全部改动」的 diff。更可控的做法是在 .gitattributes 里写 * text=auto eol=lf。
  • 正则与字符串比较:“abc\r\n” 用 $ 匹配行尾会失败,因为 \r 位于 \n 之前;逐行解析时不先剥掉 \r,字符串比较会莫名其妙地不相等。
  • 协议要求固定 CRLF:HTTP 请求/响应头、SMTP 等以 CRLF 作为行结束符,只给 LF 会被判为协议错误。
  • 二进制文件被误转换:图片、压缩包一旦被当作文本转换就会损坏,因此需要标记为 binary。
file 文件名                     # 有时会直接报出 "with CRLF line terminators"
cat -A 文件名                   # 行尾显示 ^M$ 说明是 CRLF;只有 $ 则是 LF
od -c 文件名 | head             # 直接看字节:\r \n
sed -i 's/\r$//' 文件名         # 快速把 CRLF 转成 LF
dos2unix 文件 / unix2dos 文件   # 专门的转换工具
git config core.autocrlf false  # 关掉 Git 的自动换行转换
  • 编辑器:VS Code 右下角状态栏会显示当前文件的 CRLF / LF,点击即可切换。跨团队项目建议用 .editorconfig 统一:
[*]
end_of_line = lf
charset = utf-8
  • Python:注意 open(…, newline=…)。默认的文本模式会做「通用换行」转换(读时把 CRLF / CR 都变成 \n,写时按平台转换);想拿到原始内容,要用 %%newline=''%% 或二进制模式。

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • 代码术语/lf_crlf.txt
  • 最后更改: 2026/10/11 11:12
  • 由 张叶安