Go maps.All 怎样用迭代器遍历 map 的键值对-Golang学习网

在 Go 中，如果你已经有一个 map[K]V，想把它的键和值交给统一的迭代器接口，可以使用 maps.All(m)。它返回 iter.Seq2[K, V]，因此能够直接写成 for key, value := range maps.All(m)。需要牢记的是：map 的遍历顺序没有保证，maps.All 也不会替你排序。

官方地址：https://pkg.go.dev/maps#All

结论：maps.All 适合把 map 的键值对接入 range 或其它迭代器消费者；需要稳定展示时，先收集并排序键，不要依赖某一次遍历的顺序。

确认 maps.All 返回什么

maps.All 的输入是一个 map，输出不是新的 map，也不是切片，而是一个键值迭代器 iter.Seq2[K, V]。它把每一对键和值交给消费者处理，调用方不需要先手写一个临时切片。

Go map 经过 maps.All 转成 iter.Seq2 键值迭代器的结构关系说明图 — 图1：maps.All 输入关系说明图，展示 map 到键值迭代器的类型关系，不是运行截图。

从职责上看，map 负责保存键值关系，maps.All 负责提供迭代入口，iter.Seq2 负责表达“每次产生两个值”。这三个概念不要混成“复制出一个有序集合”。

用 range 消费键值迭代器

Go 支持把函数形式的迭代器交给 range。下面的代码直接读取每个键和值，适合把 map 内容转换成日志、统计结果或下游调用参数。

package main

import (
    "fmt"
    "maps"
)

func main() {
    scores := map[string]int{
        "alice": 92,
        "bob":   87,
        "carol": 95,
    }

    for name, score := range maps.All(scores) {
        // All 每次提供一组键和值，业务逻辑直接处理结构化数据。
        fmt.Printf("%s=%d\n", name, score)
    }
}

这里的 name 和 score 是正常的结构化变量，不需要从字符串中拆字段。若只关心键或只关心值，可以分别考虑 maps.Keys 和 maps.Values，不必为了丢弃一个返回值而保留多余逻辑。

另外，输出行的先后次序不应作为业务判断依据。同一份 map 在两次遍历中可能得到不同顺序，测试断言也不要直接比较未经排序的文本。

把迭代器接入 maps.Insert

迭代器的价值在于可组合。maps.Insert(dst, seq) 可以把键值迭代器中的元素写入目标 map，因此可以把 maps.All(src) 直接作为输入。

maps.All 生成键值迭代器并被 range、maps.Insert、maps.Collect 消费的结构关系图 — 图2：键值迭代器消费关系说明图，展示 All 与多个消费者的连接方式，不是运行截图。

package main

import (
    "fmt"
    "maps"
)

func main() {
    source := map[string]int{"red": 1, "blue": 2}
    target := map[string]int{"green": 3}

    // All 产生键值迭代器，Insert 逐项写入目标 map。
    maps.Insert(target, maps.All(source))

    fmt.Println(target)
}

maps.Insert 会更新 target。如果源 map 与目标 map 有相同键，写入目标的值会覆盖原值；因此在合并配置、拼接索引或复制一组键值对之前，要先确定覆盖是否符合业务规则。这个例子说明的是数据流组合，不代表输出 map 有固定打印顺序。

需要稳定输出时先处理排序

maps.All 不负责排序。如果目标是生成可复现的文本、签名输入或测试快照，应先把键取出，再使用合适的比较规则排序，最后按排序后的键读取 map。

func sortedNames(scores map[string]int) []string {
    names := make([]string, 0, len(scores))
    for name := range maps.Keys(scores) {
        // Keys 同样不承诺顺序，先收集成切片才能排序。
        names = append(names, name)
    }

    slices.Sort(names)
    return names
}

上面的函数需要额外导入 slices。稳定输出的关键不是把 maps.All 强行改造成有序迭代器，而是把“遍历”和“排序”拆成两个明确步骤：先决定顺序，再按顺序读取值。

All、Keys、Values 和 Collect 怎么选

需求	推荐 API	得到的形态
同时读取键和值	`maps.All(m)`	`iter.Seq2[K, V]`
只遍历键	`maps.Keys(m)`	`iter.Seq[K]`
只遍历值	`maps.Values(m)`	`iter.Seq[V]`
把键值迭代器收回 map	`maps.Collect(seq)`	新的 `map[K]V`
把键值迭代器写入已有 map	`maps.Insert(dst, seq)`	更新目标 map