Go strings.Lines 怎样逐行遍历文本并保留空行

处理配置、日志或模板文本时，常见需求是“按行读取，但不要把换行信息悄悄丢掉”。Go 的 strings.Lines 正好提供了这个边界：它返回一次性 iter.Seq[string]，逐个产生以换行符结尾的行；如果原文最后没有换行，最后一项也会保留为不带换行的尾行。

官方文档：https://pkg.go.dev/strings#Lines

结论先说：用 for line := range strings.Lines(text) 消费文本。连续换行会形成空行，空字符串不会产生任何行；不要把返回值当成可重复遍历的切片。

先看 strings.Lines 返回的是什么

strings.Lines 从 Go 1.24.0 起提供。它的返回类型不是 []string，而是 iter.Seq[string]。这意味着函数把“下一行如何产生”封装起来，调用方可以用 range 逐项消费，不必先把整个文本拆成切片。

这个设计适合文本较长、只需要顺序处理的场景。它的代价也很明确：返回的是一次性迭代器，不能像切片那样保存后反复遍历；如果业务需要索引、随机访问或多次复用，应在自己的边界上主动收集。

用 range 消费完整行

最小用法是直接对返回值使用 range。示例只展示消费关系，不把输出写成已经在本机执行得到的证据。

package main

import (
	"fmt"
	"strings"
)

func main() {
	text := "name=go\nmode=教程\n"

	// Lines 返回一次性迭代器；range 每次拿到一整行，通常包含结尾换行符。
	for line := range strings.Lines(text) {
		// 用 %q 显示不可见的换行，便于区分行内容和分隔符。
		fmt.Printf("%q\n", line)
	}
}

这里的“整行”包含换行符，而不是只包含可见文字。后续如果要写回文件、计算原始行长度或保持文本格式，这个属性很有用；如果只需要展示文字，可以在自己的处理边界调用 strings.TrimSuffix(line, "\n")，不要在读取阶段误以为换行本来就不存在。

空字符串、连续换行和没有尾部换行

这三个输入最容易造成误判。空字符串不会产生任何项；两个换行符相邻时，中间会形成一个长度为零但仍属于一行的空行；若文本没有以换行结尾，最后的非空内容仍会作为一项返回，只是它不带换行符。

package main

import (
	"fmt"
	"strings"
)

func show(label, text string) {
	fmt.Println(label)
	// 通过序号观察空行；%q 会保留换行符的可见转义。
	index := 0
	for line := range strings.Lines(text) {
		fmt.Printf("%d: %q\n", index, line)
		index++
	}
	// 没有任何迭代项时，index 仍为零，表示输入没有可产生的行。
	fmt.Printf("count=%d\n", index)
}

func main() {
	show("empty", "")
	show("blank-line", "a\n\n b")
	show("tail-without-newline", "a\nb")
}

不要用“返回数量等于换行符数量”来推断行数：末尾有换行时，最后一个换行已经结束上一行，并不会额外凭空产生一个空行；连续换行的中间位置才对应空行。真正需要保留哪些边界，应由输入格式和下游协议决定。

选择 Lines 还是 SplitAfter

如果项目已经使用 Go 1.24 或更高版本，并且目标是顺序消费长文本，strings.Lines 的表达更直接。它把“按行产生数据”的意图放在类型上，调用方不必先分配完整结果切片。

如果项目需要支持更旧的 Go 版本，或者后续逻辑必须索引访问，可以考虑 strings.SplitAfter，但要接受一次性构造切片和相应的内存成本。两者都可能保留分隔符，区别在于迭代模型和结果容器，不要只因为函数名相似就把它们当成完全等价的 API。

使用前的判断清单

• 确认编译环境支持 strings.Lines，不要把它误当成旧版本 API。
• 确认下游需要带换行的原始行，还是只需要可见文本。
• 对空字符串、连续换行和无尾部换行分别定义预期。
• 只消费一次；需要复用时，明确收集成切片并承担内存成本。

常见问题

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

单独的末尾换行用于结束最后一行，不等于额外产生一个空行。空行通常来自连续的换行符之间存在空内容。

为什么最后一行没有换行符？

因为输入本身没有以换行符结束。Lines 保留输入边界，不会为了让每一项格式一致而人为补一个换行。

可以把 iter.Seq[string] 保存起来重复 range 吗？

不应这样设计。官方文档明确它是一次性迭代器；需要重复遍历时，应在第一次消费时显式保存结果。