Go bytes.Lines 保留换行符的遍历方式

处理配置片段、日志文本或生成器文档时，如果输入已经在内存里的 []byte，Go 1.24 提供的 bytes.Lines 是一条清晰的按行遍历路径。它返回一次性的 iter.Seq[[]byte]：带换行的行会保留行尾换行符，最后一行即使没有换行符也会返回，空输入则没有任何行。

官方地址：https://pkg.go.dev/bytes#Lines

先确认 bytes.Lines 的换行语义

bytes.Lines 的关键不是“把内容切成几段”，而是把换行边界表达成一个可 range 的序列。下面三种输入要分开理解：空切片不会产生元素；"alpha\nbeta\n" 会产生两行且两行都带 \n；"alpha\nbeta" 的第二行会返回，但不带换行符。

因此，代码不能用“每个返回值都一定以换行结尾”作为判断条件。日志拼接、协议帧解析和逐行摘要都应该把“末行没有换行”作为正常状态，而不是错误。

用 range bytes.Lines 处理逐行数据

最小写法是直接 range 返回的序列。如果后续逻辑需要完整保留原始行，就直接使用 line；如果只是展示或比较正文，可以显式去掉一个行尾换行符：

package main

import (
    "bytes"
    "fmt"
)

func main() {
    input := []byte("alpha\nbeta\nlast")

    // bytes.Lines 保留每行原有的换行符；末行没有换行符也会返回。
    for line := range bytes.Lines(input) {
        // 只为展示去掉一个行尾换行，不修改输入切片的内容。
        display := bytes.TrimSuffix(line, []byte{'\n'})
        fmt.Printf("%q\n", display)
    }
}

这里的 TrimSuffix 只服务于展示。如果换行符本身表示记录边界，应该保留 line，不要为了“看起来整齐”提前清洗。返回的切片与原始输入存在生命周期关系，若要把某一行长期交给异步任务或保存到下一次修改之后，再明确复制一份。

对比 bytes.Split 与 bufio.Scanner

三个工具都能让代码围绕“行”工作，但输入模型和边界不同。选型时先看数据是否已经完整进入内存，再看下游是否需要原始换行：

如果文章解析器需要判断原始记录是否带换行，优先让 bytes.Lines 保留这项信息；如果业务要按下标读取第三行，bytes.Split 更直接；如果数据来自网络连接或大文件，先不要把全部内容读成 []byte，应采用 Reader 方案。

处理单次迭代器和末行边界

bytes.Lines 返回的序列是 single-use。不要先遍历一次统计数量，再遍历同一个序列处理内容；需要两次视图时，重新调用 bytes.Lines(input)，或在业务确实需要时保存自己的切片。

工程上建议把换行策略写在函数契约里：原样转发就保留 \n，规范化文本就只移除一个末尾换行，记录协议边界则同时记录“是否带换行”和“是否为末行”。这样可以避免把没有换行的文件末尾误判为缺失记录，也避免把连续空行错误压缩掉。

常见问题

bytes.Lines 会返回最后的空行吗？

以换行符结束的输入不会额外产生一个空字符串行；它返回的是每个实际的换行终止行。空输入也不会产生行。

bytes.Lines 会把换行符从结果中删除吗？

不会。带换行的行包含行尾换行符；只有没有换行结束的最后一行不带换行符。

bytes.Lines 能直接替代 bufio.Scanner 吗？

不能一概替代。它适合内存中的字节切片；Scanner 适合从 Reader 逐步取 token。数据规模、长行处理和是否需要流式读取决定最终选择。