Go bytes.SplitSeq 怎样按分隔符惰性遍历字节片段

如果输入是一个较大的 []byte，又只想逐段处理，Go 1.24 起可以优先看 bytes.SplitSeq。它返回 iter.Seq[[]byte]，调用方用 range 消费每个片段，不需要先构造完整的 [][]byte。如果后续逻辑必须随机访问全部片段，再使用 bytes.Split 更直接。

这篇只讨论按字节分隔符切分的边界：怎样遍历、怎样提前停止、空分隔符和原始输入的生命周期。官方文档：https://pkg.go.dev/bytes@go1.27.3#SplitSeq

bytes.SplitSeq 和 bytes.Split 的差异

bytes.SplitSeq(s, sep) 的签名是：

func SplitSeq(s, sep []byte) iter.Seq[[]byte]

它返回一个单次消费的迭代器；每次迭代产生一个指向原始字节输入的子片段。相比之下，bytes.Split 返回 [][]byte，调用完成后可以保存、索引和重复遍历结果，但会先得到完整的切片集合。

所以选择可以先看结果用途：

用 range 消费字节片段

最小用法是把 bytes.SplitSeq 放在 range 后面。下面的示例只处理前两个片段，演示迭代器不必一次性消费完：

package main

import (
	"bytes"
	"fmt"
)

func main() {
	// 输入保留在外层，迭代产生的片段只在本次消费期间使用。
	input := []byte("user=alice;role=reader;active=true")
	separator := []byte(";")

	count := 0
	for part := range bytes.SplitSeq(input, separator) {
		// 每个 part 是原始 input 的子切片，适合立即解析或转存。
		fmt.Printf("part=%q\\n", part)
		count++
		if count == 2 {
			// 提前停止可以避免继续扫描后面的片段。
			break
		}
	}
}

示例中的 part 是 []byte，不是字符串。需要传给只接收字符串的函数时，显式写 string(part)；需要长期保存时，复制一份再放入缓存或异步任务，避免继续依赖 input 的可变底层数组。

四个输入边界要先分清

空输入

当 s 为空时，没有可产出的字段，循环不会进入。不要把“没有输出”误判成一个空字段；如果业务需要保留空记录，应先在业务层定义规则。

连续分隔符和首尾分隔符

SplitSeq 与 Split 保持相同的切分语义，但它们产生的是非空片段。比如 a;;b; 的连续或尾部分隔符不会自动变成多个空片段。若空字段有业务意义，先明确协议，再考虑手工扫描或使用能保留空项的方案。

空分隔符

空的 sep 不是“没有切分”。它会按 UTF-8 解码后的字符边界拆分输入；这与按固定字节串分割不是同一语义。处理二进制协议时，分隔符应明确写成实际字节序列，不能用空切片代替。

片段与输入的生命周期

返回片段指向原始 s 的底层存储。循环内立即读取通常没问题；跨 goroutine、写入缓存或修改原始输入前，先复制：

// clonePart 让异步任务拥有独立字节存储，避免引用可变输入。
func clonePart(part []byte) []byte {
	copyOfPart := make([]byte, len(part))
	copy(copyOfPart, part)
	return copyOfPart
}

最后按使用方式选 API

如果处理逻辑是“读到一段就判断，满足条件就停止”，bytes.SplitSeq 的表达更贴近任务；如果要对结果排序、按下标取值或重复遍历，bytes.Split 的 [][]byte 更容易管理。输入是字符串时，对应使用 strings.SplitSeq，不要为了套用字节 API 反复转换。

记住三个要点：第一，SplitSeq 返回的是单次消费的 iter.Seq[[]byte]；第二，空分隔符和连续分隔符有明确语义，不能靠直觉判断；第三，片段依赖原始输入，跨生命周期保存前应复制。

常见问题

bytes.SplitSeq 会返回空字符串或空字节片段吗？

它遵循 bytes.Split 的切分规则，分隔符连续或位于首尾时不会把这些位置自动转换成业务空字段。

可以把 SplitSeq 的结果保存起来下次再 range 吗？

不要把它当作可重复遍历的集合。若需要重复访问，应在一次遍历中复制并保存片段，或者直接使用 bytes.Split 得到 [][]byte。