Tony Bai ·

再见，map[T]struct！Go 泛型 Set 终于被官方接受了

💡 原文中文，约5700字，阅读约需14分钟。

📝

内容提要

2026年11月4日，Go团队正式接受泛型Set提案#69230，包路径为golang.org/x/exp/collection/set，底层仍为map[E]struct{}。新Set提供Of、Insert、Union、Intersection等完整API，并借助iter.Seq支持直接range遍历。提案历经十二年讨论，此次接受仅代表认可设计方向，尚属实验性实现，未进入标准库。其意义在于为公共API提供统一的集合类型表达，收敛社区手写Set的重复实践。

🔎

延伸解读

提案被接受不等于标准库可用

文章明确指出，此次提案状态变为 Accepted 仅代表 Go 团队认可设计方向，当前包路径为 golang.org/x/exp/collection/set，属于实验性项目。这意味着它尚未进入标准库，API 仍可能调整。读者需注意：现在不能直接在生产代码中依赖它作为稳定接口，也不应大规模替换现有的 map[T]struct{} 写法。

底层仍是 map，但类型语义更清晰

新 Set 定义为 type Set[E comparable] map[E]struct{}，并未引入新的底层数据结构。好处是性能、内存特征与现有 map 一致，且可直接 range。但文章提醒，最终采用 map 类型定义而非 struct 封装，因此不能认为它具备早期方案设想的零值可直接写入特性，使用时应通过 set.Of() 等构造方式创建可写集合。

迭代器集成让 Set 融入数据处理链

Set 的 All() 方法返回 iter.Seq[E]，并支持直接 range 遍历。文章指出，这使 Set 不再孤立，而是能与 Go 1.23 引入的 range over function 及迭代器生态组合。例如 Collect 可从迭代器收集元素构建 Set。对于需要频繁在切片、映射与集合间转换的代码，这种组合能力比单纯封装 map 更有实际价值。

公共 API 表达将更规范

文章强调，提案的重要价值在于为公共 API 提供统一的集合类型表达。函数签名 func ProcessTags(tags set.Set[string]) 比 map[string]struct{} 更直接地传达“字符串集合”的业务语义，而非实现细节。随着泛型和迭代器机制成熟，Go 团队正尝试收敛社区手写 Set 的重复实践，但 map[string]struct{} 不会消失，仍是底层实现。

❓

Q&A

Go 泛型 Set 提案被接受后，包路径和底层类型是什么？

包路径为 golang.org/x/exp/collection/set，底层类型定义为 type Set[E comparable] map[E]struct{}，即仍然基于 map 实现。

新的泛型 Set 提供了哪些主要 API？

提供 Of、Collect、Insert、Delete、Contains、Len、Clear、Clone、Equal、Union、Intersection、Difference、SymmetricDifference、All 等方法，其中 UnionWith、IntersectionWith、DifferenceWith 支持直接修改原集合。

为什么新的 Set 仍然基于 map 实现，而不是重新设计数据结构？

为了保持与 map 一致的性能和内存特征，兼容 Go 已有的 range 等语言能力，并使公共 API 中的类型表达更清晰（如 set.Set[string] 比 map[string]struct{} 更易理解）。

新的 Set 如何支持直接 range 遍历？

Set 利用 Go 1.23 引入的 range over function 和 iter.Seq，提供 All() 方法返回 iter.Seq[E]，并且由于底层是 map，Set 本身也可直接作为 range 的对象。

提案被接受是否意味着 Set 已经进入 Go 标准库？

不是。提案被接受仅代表 Go 团队认可了设计方向，当前包路径为 golang.org/x/exp/collection/set，属于实验性实现，尚未进入标准库，后续可能调整。

Go 社区关于 Set 的讨论经历了多长时间？

从 2014 年首次提出语言层面增加 Set 类型，到 2026 年 11 月 4 日提案 #69230 被正式接受，历时约十二年。

🏷️