Go maps.Keys 怎样稳定拿到 map 键集合

想稳定拿到 map 的键列表，不能只调用 maps.Keys：它提供键迭代器，顺序没有保证。对字符串键，使用 slices.Sorted(maps.Keys(m)) 得到排序后的切片；仅需要收集、不关心顺序时才用 slices.Collect。这里的“稳定”是按明确规则排列，不是让 map 记住插入顺序。

Go 官方地址：https://go.dev/；标准库文档：https://pkg.go.dev/maps。

maps.Keys 给的是迭代器，不是切片

标准库 maps.Keys 从 Go 1.23 引入，返回 iter.Seq[K]，不是 []K。其键遍历顺序未指定，也不保证两次调用相同。需要索引和长度的调用方，应接收收集后的切片，而不是直接对迭代器调用 len 或使用下标。依据见 maps.Keys 文档。

本文用三个对象区分职责：inventory 是原始 map，maps.Keys 是键枚举接口，iter.Seq 是迭代器类型。slices.Collect 与 slices.Sorted 是两种消费方式，keys 是物化后的切片。迭代器不是预先复制好的键快照；若业务需要固定一份名单，就在需要的时点完成收集，之后使用切片。

收集与排序写成一个完整示例

下面为 Go 1.23 及以上的独立示例，字符串键采用升序。内容顺序不随 map 初始化时的排列改变。示例没有在本文环境中运行，末尾说明的是按代码规则应得到的结果。

package main

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

func main() {
    inventory := map[string]int{
        "tea": 12,
        "rice": 8,
        "beans": 5,
    }

    // 收集但不排序：只能把它当作键集合，不能依赖下标顺序。
    collected := slices.Collect(maps.Keys(inventory))
    fmt.Println("键数量:", len(collected))

    // 字符串键按升序物化为切片，适合固定排列的展示与比较。
    keys := slices.Sorted(maps.Keys(inventory))
    fmt.Println("排序键:", keys)
}

这里应有三个键，排序列表应为 [beans rice tea]。不要为 collected 编造一个固定输出顺序。slices.Sorted 接收迭代器、收集为新切片并排序；slices.Collect 只完成收集。它们的空输入结果都是 nil，具体契约见 Sorted 与 Collect 文档。

空 map 与旧版本怎样处理

空 map 没有键可供枚举；上述收集结果长度为零。如果业务接口明确要求非 nil 的空切片，可以在返回前统一处理，不要把“无键”和“调用失败”混在一起。下面函数沿用前面的 maps、slices 导入。

// SortedNames 明确把空集合表示为非 nil 空切片。
func SortedNames(m map[string]int) []string {
    keys := slices.Sorted(maps.Keys(m))
    if keys == nil {
        return []string{}
    }
    return keys
}

若项目不能使用 Go 1.23 的迭代器相关接口，可以直接遍历并使用 sort.Strings。这是另一份实现，不要与前面的同名函数同时放进一个包。

package keylist

import "sort"

// SortedNames 用传统遍历收集，随后按字符串升序排列。
func SortedNames(m map[string]int) []string {
    keys := make([]string, 0, len(m))
    for key := range m {
        keys = append(keys, key)
    }
    sort.Strings(keys)
    return keys
}

采用新写法前，应让项目工具链与 go.mod 的语言版本覆盖所用能力。Go 1.23 对迭代器的支持见 官方发布说明。这篇只比较键集合写法，不涉及并发 map 的访问方案。

键是结构体时补齐比较规则

map 的键可以可比较，但“可比较”不等于有适合业务的升序。假设 RouteKey 包含 Zone 与 Name，排序规则可约定为先 Zone、再 Name；cmp.Compare 用于比较每一个字符串字段，slices.SortedFunc 接收完整比较函数。

package routekeys

import (
    "cmp"
    "maps"
    "slices"
)

type RouteKey struct {
    Zone string
    Name string
}

// Keys 按区域与名称形成完整排序规则，避免只比较一个字段。
func Keys(routes map[RouteKey]int) []RouteKey {
    return slices.SortedFunc(maps.Keys(routes), func(a, b RouteKey) int {
        if order := cmp.Compare(a.Zone, b.Zone); order != 0 {
            return order
        }
        return cmp.Compare(a.Name, b.Name)
    })
}

本例两个字段已经覆盖 RouteKey 的全部字段。若以后再加版本字段，要同时决定它的排序地位。只比较 Zone 会让同区域的多个不同键比较为相等；换成“稳定排序”也不能凭空提供 map 原本不存在的插入顺序。自定义比较接口见 SortedFunc 文档。

按需要选择遍历、收集或排序

为什么打印 map 看起来有序，拿出的键却变了？

不要用某种展示形式推导枚举契约；需要稳定列表，就明确收集并排序。对外接口最好直接声明返回排序切片。

键列表需要再去重吗？

普通字符串 map 的每个键已有唯一位置；本例不需要另加去重层。不要把多个 map 合并后去重的问题混入单个 map 的键提取。

每次使用都要重新排序吗？

若业务选择复用同一份已收集名单，可以复用排序后的切片，但必须自行约定名单的更新时点。不要在没有测量的情况下声称一种简写一定更快，也不要在只需遍历时为“看起来稳定”无故物化完整列表。