lo 迭代器工具详解使用 it.SeqToSeq2 为 Go 序列生成带索引的键值对【免费下载链接】lo A Lodash-style Go library based on Go 1.18 Generics (map, filter, contains, find...)项目地址: https://gitcode.com/GitHub_Trending/lo/loSeqToSeq2是 lo 库it子包基于 Go 1.18 泛型与 Go 1.23 标准库iter序列中的核心转换工具用于将一维序列iter.Seq[T]转换为带索引的键值对序列iter.Seq2[int, T]。本文以 it-seqtoseq2.md 文档为主体结合 it/seq.go 源码实现与 it/seq_test.go 测试用例讲解其语义、底层原理与实战用法读完即可在需要元素 下标的遍历场景中直接落地使用。函数签名与核心语义SeqToSeq2的定义位于 it/seq.go#L1170完整签名如下func SeqToSeq2T any iter.Seq2[int, T]其语义可以概括为一句话把序列转换为带索引的键值对序列。转换规则为输入是任意类型的单值序列iter.Seq[T]输出是双值序列iter.Seq2[int, T]第一个元素是索引int第二个元素是原始值T索引从0开始每经过一个元素递增1与切片下标语义完全一致。原文档给出的最小可运行示例seq : slices.Values([]string{foo, bar, baz}) for i, v : range it.SeqToSeq2(seq) { fmt.Printf(%d:%s , i, v) } // 0:foo 1:bar 2:baz输出结果0:foo 1:bar 2:baz直观展示了下标 值的配对关系。底层实现惰性求值与提前终止从源码结构看SeqToSeq2的实现采用了 Go 1.23iter包的函数式序列约定——返回一个接受yield func(int, T) bool回调的闭包核心逻辑见 it/seq.go#L1170-L1180func SeqToSeq2T any iter.Seq2[int, T] { return func(yield func(int, T) bool) { var i int for item : range in { if !yield(i, item) { return } i } } }这段实现透露出三个关键设计点纯惰性pull 式回调整个转换不预先分配任何切片或 map只在消费者请求时逐个产出元素内存开销为零可安全作用于无限或超长序列。索引状态机索引i作为闭包内的局部变量维护从 0 开始每次yield成功返回true后才自增保证配对严格有序。尊重提前终止early termination当消费者如for range循环中的break返回false时转换立即停止不再消费输入序列避免无谓的迭代开销。测试用例印证空序列与 break 语义it/seq_test.go#L2482-L2503 中的TestSeqToSeq2从两个角度验证了上述语义空输入input: []string{}时maps.Collect(seq)得到空 map说明空序列不产生任何键值对正常映射{foo, bar}被正确收集为{0: foo, 1: bar}索引从 0 连续递增break 支持测试通过assertSeq2SupportBreak辅助函数专门验证了消费者中途break时转换能正确终止印证了源码中的提前返回逻辑。此外it/seq_example_test.go#L776-L781 中的ExampleSeqToSeq2展示了与标准库maps.Collect的组合用法将结果直接收集为map[int]stringresult : maps.Collect(SeqToSeq2(slices.Values([]string{foo, bar, baz}))) fmt.Printf(%v %v %v %v, len(result), result[0], result[1], result[2]) // Output: 3 foo bar baz实战场景带下标的遍历SeqToSeq2最常见的用途是在for range中同时拿到元素和它的位置替代手写计数器。例如打印带行号的配置项lines : slices.Values([]string{hostlocalhost, port8080, debugtrue}) for idx, line : range it.SeqToSeq2(lines) { fmt.Printf([%d] %s\n, idx, line) }由于输出是标准的iter.Seq2它还可以无缝接入 lo 库的其他迭代器组合函数或与maps.Collect、slices.Collect等标准库收集函数配合将序列投影为下标索引的映射结构。相关的反向与投影助手在 lo 的it子包中与SeqToSeq2语义互补的还有两个方向相反的助手详见文档 frontmatter 的similarHelpers声明对应文档 it-map.md 分类下的序列转换Seq2KeyToSeq从iter.Seq2中提取全部键得到一维键序列Seq2ValueToSeq从iter.Seq2中提取全部值得到一维值序列。三者组合可以完成一维序列 → 键值对序列 → 拆回键/值序列的完整闭环是it包序列转换工具箱中的重要拼图。小结it.SeqToSeq2以极简的闭包实现完成了序列到带索引键值对的惰性转换索引从 0 连续递增、支持消费者提前终止、零额外内存分配。无论是给元素编号、构建索引 map还是与Seq2KeyToSeq/Seq2ValueToSeq搭配做序列投影它都是 lo 迭代器体系里值得优先掌握的基础工具。【免费下载链接】lo A Lodash-style Go library based on Go 1.18 Generics (map, filter, contains, find...)项目地址: https://gitcode.com/GitHub_Trending/lo/lo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考