Go maps.All 怎样用迭代器遍历 map 的键值对

在 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]。它把每一对键和值交给消费者处理，调用方不需要先手写一个临时切片。

从职责上看，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) 直接作为输入。

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 需要 map，再使用 maps.Collect；如果已有目标 map 且接受覆盖语义，可以使用 maps.Insert。

三个容易混淆的边界

1. All 不会复制成排序后的副本。它提供的是遍历入口，不承诺顺序，也不改变源 map。
2. 迭代器不是快照协议。不要把遍历期间对 map 的并发读写当成安全用法；共享 map 仍需遵循 Go 的并发访问规则。
3. 展示格式不能替代结构化字段。需要稳定结果时，按键排序；需要业务判断时，直接使用键和值，不要解析打印字符串。

一份可复用的判断清单

• 需要同时拿到键和值：使用 maps.All。
• 需要直接逐项消费：用 range maps.All(m)，不要先创建临时切片。
• 需要合并到现有 map：把 maps.All(src) 交给 maps.Insert，先确认重复键覆盖规则。
• 需要稳定文本或测试快照：先收集键并排序，再读取 map 值。
• 需要重新得到一个 map：使用 maps.Collect，并明确这是一次新的容器构造。

常见问题

maps.All 的遍历顺序固定吗？

不固定。官方文档明确说明 map 的迭代顺序没有保证，也不能假设连续调用返回相同顺序。

maps.All 会修改原 map 吗？

单独调用 maps.All 只是提供键值迭代器，不会因为生成迭代器就复制或排序原 map。若把它交给 maps.Insert，被修改的是目标 map。

什么时候不用 maps.All？

只需要键时用 maps.Keys，只需要值时用 maps.Values；需要有序结果时，不要把任意一次 All 遍历当成排序结果。