Go strings.Lines 怎么处理末尾换行：迭代语义、空输入与测试边界

把配置文本按行读取时，最容易误判的不是中文，而是最后那个换行符：strings.Lines 返回的每一项会保留自己的结尾换行，空字符串则一项都没有；如果原文没有以换行收尾，最后一行仍会被返回，只是末尾没有 \n。这个函数从 Go 1.24 开始提供，返回的是只能消费一次的迭代器。

先把三种输入的返回值打印出来

不要从函数名猜行为，先用带引号的输出看边界。下面的程序分别测试末尾有换行、末尾没有换行和空字符串：

package main

import (
    "fmt"
    "strings"
)

func dump(name, text string) {
    fmt.Println(name)
    for line := range strings.Lines(text) {
        fmt.Printf("%q\n", line)
    }
}

func main() {
    dump("with-newline", "alpha\nbeta\n")
    dump("without-newline", "alpha\nbeta")
    dump("empty", "")
}

输出的关键部分应该是："alpha\n"、"beta\n"；第二组最后是 "beta"；第三组没有任何行。这里别急着把结果和 strings.Split 对齐，它们处理分隔符的目标不同。

为什么末尾换行不会多出一个空字符串

把 "alpha\n" 想成“第一行结束”，而不是“第一行加一个空行”，就容易理解了。Lines 只产生真实存在的行：换行符属于前一行的结尾，后面没有新的字符，也就没有第二行。

这和很多人第一次使用 strings.Split(text, "\n") 时看到的结果不一样。Split("alpha\n", "\n") 会得到一个空的尾元素；如果业务是逐行处理日志、配置或协议片段，那个空元素往往需要额外判断。Lines 则把换行保留在行里，让“原文最后是否换行”这个事实不丢失。

需要纯文本行时，在消费点去掉换行

如果下游只接受不带换行的字段，可以在 range 内明确处理，而不是事先复制一份字符串或退回手工切分：

for line := range strings.Lines(text) {
    line = strings.TrimSuffix(line, "\n")
    line = strings.TrimSuffix(line, "\r")
    if line == "" {
        continue
    }
    handle(line)
}

上面分两次去除是为了兼容 CRLF：对 "beta\r\n"，先去掉 \n，再去掉 \r。如果你还要保留空行来维护配置文件的行号，就不要写 continue；“清理行尾”和“过滤空行”是两个不同决定。

一次性迭代器不能拿来做两轮遍历

strings.Lines 返回 iter.Seq[string]，同一个值只允许消费一次。下面的写法不会得到两份数据：

lines := strings.Lines("a\nb\n")

for line := range lines {
    fmt.Print(line)
}

for line := range lines {
    fmt.Print(line) // 不会再次输出 a、b
}

要统计后再处理，请在第一次消费时保存需要的数据；要重复遍历，就重新调用 strings.Lines(text)。这不是“迭代器偶尔失效”，而是它为了流式消费而明确规定的生命周期。

用表驱动测试锁住换行边界

测试重点不是只断言行数，还要断言每个元素是否保留了换行符，以及空输入是否为零项：

func collect(text string) []string {
    var got []string
    for line := range strings.Lines(text) {
        got = append(got, line)
    }
    return got
}

func TestLinesBoundaries(t *testing.T) {
    tests := []struct {
        name string
        text string
        want []string
    }{
        {"trailing-newline", "a\nb\n", []string{"a\n", "b\n"}},
        {"last-line-without-newline", "a\nb", []string{"a\n", "b"}},
        {"empty", "", nil},
    }
    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {
            if got := collect(tt.text); !reflect.DeepEqual(got, tt.want) {
                t.Fatalf("collect(%q) = %#v, want %#v", tt.text, got, tt.want)
            }
        })
    }
}

示例省略了导入部分，实际测试需要同时导入 reflect、strings 和 testing。如果项目约定统一成 LF，还应单独加入 CRLF 输入用例；不要把换行格式假设藏在辅助函数里。

常见问题

strings.Lines 会返回最后一个空行吗？

不会。输入以换行符结束时，换行符属于前一行；只有存在实际字符时才会产生最后一项。

它和 strings.Split 最大的区别是什么？

Lines 返回保留行尾换行的单次迭代器，不会为末尾分隔符凭空增加空元素；Split 返回切片，并按分隔符切分出尾部空字符串。

怎么判断原文最后一行有没有换行？

消费每一项时检查 strings.HasSuffix(line, "\n")；最后一项没有该后缀，就说明原文没有以 LF 结束。CRLF 文本也会以 \n 结束，但行内还保留 \r。

可以把同一个 iter.Seq 传给两个函数吗？

除非明确保证只有一个函数消费，否则不要这样设计。更稳妥的做法是传入原始字符串并在需要处重新调用 strings.Lines，或者先收集成切片再共享。

落地时记住三个判断

用 strings.Lines 处理文本时，先确认下游要“原始行”还是“纯文本行”，再决定是否去掉行尾；用带引号的输出锁住末尾换行、无换行和空输入三个边界；如果需要二次遍历，就重新创建迭代器。这样既能利用 Go 1.24 的流式接口，也不会把换行语义和迭代器生命周期混成一个隐蔽的 bug。