Go maps.Keys 怎样获取 map 的全部键

在 Go 1.23 及更新版本中，获取 map 的全部键可以直接使用 maps.Keys。它返回的是键迭代器 iter.Seq[K]，不是已经分配好的切片；要复用键集合时，用 slices.Collect(maps.Keys(m)) 收集成 []K，而需要稳定输出时再显式使用 slices.Sorted。

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

最常用的写法是 keys := slices.Collect(maps.Keys(m))。如果后续要生成日志、JSON 或测试快照，不要依赖 map 的遍历顺序，应改成 keys := slices.Sorted(maps.Keys(m))。

maps.Keys 返回的到底是什么

maps.Keys 的签名是 func Keys[Map ~map[K]V, K comparable, V any](m Map) iter.Seq[K]。关键点是返回值为 iter.Seq[K]：它描述一组可以被 range 消费的键，而不是马上创建一个切片。

这样设计适合只需要遍历一次的场景，可以少写一个临时切片；如果业务确实需要保存、传递或排序，才把它收集成 []K。

两种获取全部键的写法

只想遍历键时直接 range 即可。下面的示例把键和值分开使用：键来自 maps.Keys，值仍通过原 map 查询；代码中的中文注释说明了迭代器和缺省值边界。

package main

import (
    "fmt"
    "maps"
)

func main() {
    scores := map[string]int{"go": 100, "rust": 95}

    // Keys 返回可被 range 消费的键迭代器，不会承诺键的顺序。
    for key := range maps.Keys(scores) {
        // 通过原 map 读取值，缺失键时仍会得到该值类型的零值。
        fmt.Println(key, scores[key])
    }
}

如果要把全部键交给另一个函数或后续排序，可以使用 slices.Collect：

package main

import (
    "fmt"
    "maps"
    "slices"
)

func main() {
    scores := map[string]int{"go": 100, "rust": 95}

    // Collect 把键迭代器物化为可保存、可传递的 []string。
    keys := slices.Collect(maps.Keys(scores))
    fmt.Println(keys)
}

空 map 会得到什么结果

对 nil map 或没有元素的 map 调用 maps.Keys，迭代器不会产生任何键；收集后得到长度为 0 的切片。代码不需要先判断 map 是否为 nil，除非业务要区分“没有键”和“输入本身为 nil”这两种语义。

package main

import (
    "fmt"
    "maps"
    "slices"
)

func main() {
    var empty map[string]int

    // 空迭代器可以安全收集，len 为 0；这里不把 nil 当成异常。
    keys := slices.Collect(maps.Keys(empty))
    fmt.Println(len(keys) == 0)
}

len(keys) == 0 只说明没有可迭代的键；它不能说明原 map 一定是 nil，因为空的非 nil map 也会得到同样的键数量。

为什么拿到的键顺序不能直接依赖

官方文档明确说明 maps.Keys 的迭代顺序未指定，也不保证同一个 map 的两次调用保持相同顺序。因此日志快照、接口返回、签名输入、单元测试中的字符串比较，以及任何需要稳定 diff 的输出，都不应直接使用自然结果。

package main

import (
    "fmt"
    "maps"
    "slices"
)

func main() {
    scores := map[int]string{30: "thirty", 10: "ten", 20: "twenty"}

    // Sorted 先消费 Keys，再按键的自然顺序生成稳定切片。
    stableKeys := slices.Sorted(maps.Keys(scores))
    fmt.Println(stableKeys)
}

slices.Sorted 要求元素满足排序约束；字符串和整数键可以直接使用。若键是自定义结构或只支持业务排序规则，就先收集到切片，再用 slices.SortFunc 指定比较函数。

版本与选择建议

maps.Keys 从 Go 1.23 加入标准库的 maps 包。如果项目需要兼容更旧的 Go 版本，可以保留传统的 for key := range m { keys = append(keys, key) }，但不要为了“看起来有序”而把某次输出顺序当成契约。

常见问题

maps.Keys 能直接得到 []K 吗？

不能。它返回 iter.Seq[K]；需要切片时使用 slices.Collect，需要排序时使用 slices.Sorted。

空 map 调用 maps.Keys 会 panic 吗？

不会。nil map 和空 map 都不会产生键，收集后的切片长度为 0。

为什么两次打印键的顺序不同？

map 键迭代顺序没有保证。需要稳定结果时显式排序，而不是修改业务逻辑去适配某一次输出。