Go maps.All 怎样把 map 键值交给 range 函数迭代

如果你手里已经有一个 map[K]V，只是想把键和值交给新的 range 迭代器，最小写法就是 for k, v := range maps.All(m)。maps.All 返回的是 iter.Seq2[K, V]，所以循环仍然能同时拿到 key 和 value；但 map 的遍历顺序没有保证，不能把它当成排序结果。

这个函数适合“把 map 接入需要 iter.Seq2 的代码”或“让消费方用 break 提前结束”的场景。若只是普通地读一遍 map，直接写 for k, v := range m 更短；选哪个，取决于调用方是否需要迭代器形态。

官方资料：https://pkg.go.dev/maps#All

先看最小写法：range 直接接收键和值

maps.All 在 Go 1.23 加入，签名中的 Map ~map[K]V 表示普通 map 以及底层类型为 map 的自定义类型都可以传入。下面的代码只展示消费关系，不依赖某个固定输出顺序。

package main

import (
    "fmt"
    "maps"
)

func main() {
    prices := map[string]int{
        "coffee": 18,
        "tea":    12,
    }

    // maps.All 把 map 适配成键值对迭代器，range 同时接收键和值。
    for name, price := range maps.All(prices) {
        // map 的遍历顺序未定义，这里只输出当前拿到的键值对。
        fmt.Printf("%s=%d\\n", name, price)
    }
}

这里的关键不是把 map 复制成切片，而是把它包装成一个可被 range 消费的 Seq2。调用方仍然按 map 的遍历语义得到元素：元素数量来自当前 map，顺序不参与业务结论。

它和直接 range 的差别，主要在“接口形态”

我在把一段 map 遍历接到通用迭代器代码时，最容易误判的一点是：maps.All 并没有把 map 变成有序集合，也没有额外提供排序能力。它解决的是接口适配，而不是顺序问题。

因此，已经处在普通函数体内时，直接 range 往往最清楚；需要把键值对作为 iter.Seq2 继续传给别的函数时，maps.All 才体现出价值。

需要提前结束时，break 会怎样传回去

标准库实现内部用一个 yield func(K, V) bool 接收消费方的反馈。消费方继续迭代时，这个反馈保持为真；遇到 break 时，range 机制会让迭代器收到停止信号，后续 map 元素不会继续交给当前循环。

package main

import (
    "fmt"
    "maps"
)

func main() {
    scores := map[string]int{
        "alice": 92,
        "bob":   58,
        "cindy": 76,
    }

    for name, score := range maps.All(scores) {
        // 找到一个低于及格线的记录就停止消费，不保证先遇到谁。
        if score 

这段逻辑只能表达“是否存在一个低于 60 分的元素”，不能表达“按姓名顺序找到第一个低于 60 分的元素”。如果业务需要稳定顺序，应先把键取出、排序，再按排序后的键访问 map；不能靠 maps.All 改变 map 本身的无序性质。

自定义 map 类型、nil map 和空结果

签名里的波浪号允许底层类型为 map 的命名类型参与调用。例如业务代码把 map 包装成了更有语义的类型，不需要先转换回匿名 map。

package main

import (
    "fmt"
    "maps"
)

type Labels map[string]string

func main() {
    var labels Labels

    // nil map 没有键值对，迭代会自然结束，不需要额外初始化。
    for key, value := range maps.All(labels) {
        // 只有存在元素时才会进入循环体。
        fmt.Println(key, value)
    }
}

空 map 和 nil map 都不会产生循环元素；这和直接 range map 的直觉一致。另一方面，maps.All 不会替你解决并发读写问题：如果多个 goroutine 同时修改同一个 map，仍然需要在数据结构层面提供同步或改用合适的并发容器。

什么时候选 maps.All，什么时候不用

可以把选择压缩成三个问题：

• 调用方是否要求 iter.Seq2[K,V]？要求就用 maps.All。
• 只是当前函数读取 map？直接 range m 更直白。
• 是否需要固定顺序？两者都不负责排序，应显式准备并排序键。

还要注意版本边界：官方文档把 maps.All 标记为 Go 1.23.0 新增。项目的 go.mod 和构建工具链低于这个能力时，不能因为本机能看到新文档就直接使用；需要升级工具链，或继续采用旧版本可用的直接 map range。

几个容易混淆的问题

maps.All 会按 key 排序吗？

不会。官方定义明确说迭代顺序未指定，也不保证同一次程序的两次调用保持一致。

可以只用一个变量接收 maps.All 吗？

不适合把它当成单值迭代器。maps.All 返回的是 Seq2，设计目标就是把 key 和 value 作为一对交给 range；若只关心其中一侧，可考虑 maps.Keys 或 maps.Values。

break 后 map 会被修改吗？

不会。break 只停止当前消费过程，maps.All 不负责写入、删除或排序 map；是否修改数据仍由循环外的业务代码决定。

总结一下：把 map 接到 Go 的迭代器接口时使用 maps.All，直接 range maps.All(m) 就能同时获得键和值；需要提前结束时用 break，需要稳定顺序时另行排序。把这三个边界分开，代码就不会把“方便消费”误认为“改变 map 语义”。