Go iter 怎样把 map 迭代封装成可组合序列

如果你想把一个 map 的键值遍历交给多个函数复用，Go 1.23 以后可以用 maps.All 返回 iter.Seq2，再把过滤、提前停止和收集分别封装成适配器。这样做的重点不是给 map 排序，而是统一“如何产生键值对”的接口。

官方文档：https://pkg.go.dev/iter

map 迭代为什么适合用 Seq2 表达

iter.Seq2[K,V] 的本质是一个函数：它接收一个能处理键和值的 yield 回调，并在需要时停止继续传值。maps.All 已经提供了这个适配，因此不必先把 map 转成临时切片。

package main

import (
	"fmt"
	"maps"
)

func main() {
	metrics := map[string]int{"api": 92, "cache": 81, "queue": 74}

	// maps.All 返回键值序列；map 的遍历顺序不应当被业务依赖。
	for name, score := range maps.All(metrics) {
		fmt.Println(name, score)
	}
}

这个写法要求 Go 1.23 或更高版本，因为“对函数类型使用 for range”和标准库 iter 都在 Go 1.23 引入。序列只在消费时产生键值，不等于已经创建了一份排序后的快照。

怎样把 map 入口封装成可复用序列

如果多个业务函数都要读取同一类 map，可以把入口固定为 iter.Seq2。调用方只依赖序列契约，底层今后换成索引、树或其他集合时，过滤器和消费者无需一起改动。

package report

import (
	"iter"
	"maps"
)

// Entries 把 map 的键值遍历隐藏在统一的 Seq2 接口后面。
func Entries(values map[string]int) iter.Seq2[string, int] {
	return maps.All(values)
}

// HighValues 保留达到阈值的键值，并把下游的停止信号继续向上传递。
func HighValues(seq iter.Seq2[string, int], min int) iter.Seq2[string, int] {
	return func(yield func(string, int) bool) {
		for name, score := range seq {
			if score 

这里的 HighValues 没有复制 map，也没有规定遍历顺序。它只是把“是否保留”放在当前层，把“如何输出”交给下游；这就是序列可以组合的原因。

过滤、提前停止和收集怎样配合

序列可以继续交给 for range，也可以在消费端用 break 提前结束。对适配器来说，关键是检查下游 yield 的返回值并立即 return；否则上游仍可能继续读取数据。

package main

import (
	"fmt"
	"maps"
)

func main() {
	metrics := map[string]int{"api": 92, "cache": 81, "queue": 74}
	selected := HighValues(maps.All(metrics), 80)

	for name, score := range selected {
		// 业务只需要第一条结果时，break 会让序列尽早停止。
		fmt.Println(name, score)
		break
	}

	// 只有确实需要 map 快照时才收集，避免无目的的物化。
	_ = maps.Collect(selected)
}

maps.Collect 会把 iter.Seq2 重新收集为 map；如果序列里出现重复键，后出现的值会覆盖先出现的值。若只是打印、统计或找到第一条满足条件的记录，直接消费序列更合适。

使用时要记住的边界

常见问题

maps.All 会让 map 按 key 排序吗？

不会。它返回键值迭代器，顺序不指定，也不能依赖不同调用之间保持一致。需要稳定顺序时，应先明确排序需求并选择适合的键序列处理方式。

为什么适配器必须处理 yield 返回值？

因为下游可能只需要一部分数据，或者在 break 后结束消费。适配器忽略 false 就会继续访问上游，失去迭代器的提前停止语义。

iter.Seq2 只能来自 map 吗？

不能这样理解。map 只是标准库已经提供的一个来源；任何能按照 yield func(K,V) bool 契约提供键值的集合，都可以暴露为 iter.Seq2。

总的来说，把 map 封装成可组合序列的最小路径是：用 maps.All 暴露 iter.Seq2，在适配器中保留 yield=false 的停止语义，最后只在确实需要快照时调用 maps.Collect。这样 map 的来源、过滤规则和消费方式就能分开演进。