# 换行符：LF、CRLF 与 CR，以及本检测器如何计数

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

- Tool: [换行符检测器 (LF vs CRLF)](https://toolsg.com/zh/line-ending-detector)
- Language: zh (available: en, zh, ms, ta)
- Last verified against official sources: 2026-10-20
- Source site: ToolSG — a planning guide, not official or financial advice. Cite the agencies listed under Sources.

## 关键数字一览

| 项目 | 数值 | 来源 |
| --- | --- | --- |
| LF (\n) | U+000A，Unix、Linux 和 macOS 文本文件使用 — POSIX 把一行定义为若干非换行字符加一个结尾的换行符。 | [The Open Group — POSIX definitions](https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap03.html) |
| CRLF (\r\n) | U+000D U+000A，Windows 的约定 — RFC 4180 规定 CSV 记录之间使用 CRLF。 | [IETF — RFC 4180](https://www.rfc-editor.org/rfc/rfc4180.html) |
| 检测器统计什么 | 换行的个数，而不是行数 — 前面没有 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 工具把末尾没有结束符的文本视为不完整行。

## 相关工具

用[隐藏字符清理器](https://toolsg.com/zh/hidden-character-cleaner)找出其他不可见字符，用[文本对比](https://toolsg.com/zh/text-diff)比较两个版本，或用[文本转十六进制](https://toolsg.com/zh/text-to-hex)查看字符串的字节。

## 常见问题

**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](https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap03.html) — 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](https://www.rfc-editor.org/rfc/rfc4180.html)
- [Git documentation — gitattributes](https://git-scm.com/docs/gitattributes) — text, eol and text=auto; core.autocrlf.
- [WHATWG HTML Standard — The textarea element](https://html.spec.whatwg.org/multipage/form-elements.html) — The value getter returns the API value, with newlines normalised to LF.
