Go maps 用 Collect 生成新映射

maps.Collect 接收 iter.Seq2[K, V] 键值序列，并返回一个新建的 map[K]V。把记录转成业务索引时，关键是让迭代器给出业务键，而不是直接把切片下标当成键。该函数从 Go 1.23 起提供。

我会把这个任务拆成“记录来源、键规则、新容器、查询、异常、清理”六件事。下面用一份假设的商品库存数据说明设计取舍，示例不是生产运行记录。

官方文档地址：https://pkg.go.dev/maps

数据来源：把业务记录定义成键值序列

设定输入是有顺序的 []Product，目标是用商品编码查询库存。SKU 是键，Stock 是值；序列中的两个参数要表达这两个业务字段。直接使用 slices.All(rows) 会得到下标和整条记录，适合位置索引，却不符合这里的商品查询需求。

下面是完整的独立程序。使用支持 Go 1.23 或以上语言特性的工具链与模块配置；导入的是标准库 maps、iter 与 slices，无需额外安装同名第三方库。

package main

import (
    "fmt"
    "iter"
    "maps"
    "slices"
    "strings"
)

type Product struct {
    SKU string
    Stock int
}

func stockPairs(rows []Product) iter.Seq2[string, int] {
    return func(yield func(string, int) bool) {
        for _, row := range rows {
            key := strings.TrimSpace(row.SKU)
            // 本例约定跳过空编码；同名编码由后面的记录覆盖。
            if key == "" {
                continue
            }
            // 尊重消费者停止信号，避免继续生产无用数据。
            if !yield(key, row.Stock) {
                return
            }
        }
    }
}

func main() {
    rows := []Product{
        {SKU: " kit-a ", Stock: 8},
        {SKU: "kit-b", Stock: 5},
        {SKU: "kit-a", Stock: 12},
        {SKU: " ", Stock: 99},
    }
    // 消费键值序列，得到独立的 map 容器。
    inventory := maps.Collect(stockPairs(rows))
    value, exists := inventory["kit-a"]
    fmt.Println("kit-a", value, exists)
    // 展示顺序由已排序的键决定，不依赖 map 遍历顺序。
    for _, key := range slices.Sorted(maps.Keys(inventory)) {
        fmt.Println(key, inventory[key])
    }
}

校验规则：先决定空键与重复键怎么办

我更愿意在代码旁边明确约定：去掉编码两端空白，空编码不进入索引，同键保留后出现的库存。这样，" kit-a " 和 "kit-a" 归为同一个业务键；清洗动作会造成键合并，所以它必须是业务选择。

按这份示例数据推导，kit-a 对应 12，kit-b 对应 5，空编码记录不参与。这里说的是代码应有的含义，没有展示未经执行的终端输出。

覆盖规则只对迭代器实际提供的先后次序成立。本例按切片顺序产生键值，因此取舍可预测。如果从另一个 map 遍历后把多个旧键归一化成同一新键，遍历顺序不确定，最后保留谁也不能作为稳定业务规则。

存储模型：Collect 创建的是哪一个 map

“新映射”首先指新容器，不等于对值做深拷贝。当前示例的值是整数，写入结果中的某个库存不会回写 rows 中的字段；若值改成切片或指针，容器仍然新建，但内部引用可能共享。

// 这是独立片段；放在已导入 maps 的函数中。
source := map[string][]string{"kit-a": {"red", "small"}}
snapshot := maps.Collect(maps.All(source))

// 替换某个 map 条目只改变新容器；修改共享切片元素会影响双方。
snapshot["kit-a"][0] = "blue"
snapshot["kit-a"] = []string{"green"}

第一条赋值修改两张 map 所引用的共同切片元素；第二条赋值给新容器换了一份切片。若要隔离内部对象，需要按领域结构复制切片、指针指向的数据及嵌套字段；Collect 不会自动遍历对象图完成这件事。

查询路径：用业务键访问并稳定展示

索引建好之后，用 value, exists := inventory[key] 区分“库存为零”和“编码不存在”。单值读取在这两种情况下都会得到整数零值。查询端也要使用同样的编码规则，否则带空白的输入可能匹配不到已清洗的键。

序列负责提供数据，Collect 会消费序列并把结果物化到内存。它不会给 map 增加排序属性。需要稳定展示时，把键收集并排序，再逐键读取；上面程序就是这种写法。数据量大时，还要考虑结果 map 和展示键列表的内存占用，不要仅因输入是迭代器就认为整个任务不需要保存数据。

异常处理：何时保留显式循环

如果重复编码代表输入错误，我会保留显式循环。理由很具体：Collect 的返回值没有业务错误通道，隐式跳过或悄悄覆盖容易把坏数据变成看似完整的索引。以下函数与前面的 Product 类型搭配使用，额外导入 fmt 和 strings。

func buildStrict(rows []Product) (map[string]int, error) {
    index := make(map[string]int, len(rows))
    for pos, row := range rows {
        key := strings.TrimSpace(row.SKU)
        if key == "" {
            return nil, fmt.Errorf("第 %d 条记录的编码为空", pos+1)
        }
        if _, exists := index[key]; exists {
            // 拒绝重复编码，调用方拿不到半成品索引。
            return nil, fmt.Errorf("第 %d 条记录重复编码 %q", pos+1, key)
        }
        index[key] = row.Stock
    }
    return index, nil
}

这个严格版本和 Collect 示例有意采用不同规则：前者拒绝，后者跳过空键并覆盖重复键。选定规则后再选 API，比把所有校验都藏进迭代器更容易维护。若输入本身来自可能出错的文件或网络，错误读取、资源关闭与结果发布也应由外层显式管理。

清理策略与常见问题

迭代器若捕获了原始切片，它并不天然是数据快照。不要一边修改输入一边收集；跨 goroutine 使用时也要管理共享数据的同步。Collect 不提供并发保护。新 map 不使用后，只要不再被引用，就可以由垃圾回收处理；map 本身没有 Close 方法。

空序列会返回 nil 吗？官方当前实现使用 make 创建 map，因此不产生键值的有效迭代器会得到可写的空 map。不要把一个 nil 函数冒充空序列；两者不同。

Collect 会帮我把多个库存相加吗？不会。同键赋值是覆盖，库存求和需要在生产序列前或显式循环中定义聚合逻辑。

已经有一张 map，还值得 Collect(All(m)) 吗？接口衔接时可以这样表达新容器；单纯浅复制通常直接使用 Clone 更清楚。是否需要深复制仍由值的结构决定。

什么时候我会选择它？当键值序列已经自然存在、覆盖规则明确、输入没有需要上报的业务错误时。需要拒绝重复、记录错误位置或控制容量时，普通循环仍然合适。

参考：Go maps 标准库文档、maps 迭代器实现、Go 1.23 的迭代器新增 API。