goframe 把泛型引入容器组件,同时保留了多种原有容器的使用入口。官网 2026 年 1 月 28 日的 v2.10 发布说明列出了两类变化:一类是新增带类型参数的容器,另一类是既有容器的底层改用泛型实现。框架 v2.10.0 的 github 发行记录标的是 1 月 26 日,两处记录分别对应发行版与中文版说明。

泛型带来的直接变化是,开发者在声明容器时就能指定存储的数据类型。数组组件新增了 TArray 和 SortedTArray,集合、链表和对象池也各有泛型类型。过去需要在取值后用类型断言确认数据类型的代码,迁到键和值类型都确定的泛型接口后,一些类型误用在编译时就能发现。
字典组件的名称需要对照实际代码。发布概要把变化写作哈希、链式和树形映射的泛型支持,组件文档列出的泛型入口分别是 KVMap、ListKVMap 和 TreeKVMap。以哈希映射为例,v2.10.0 源码要求键是可比较类型,并在类型参数中明确值的类型。构造函数还保留是否开启并发安全的选项。

这次改动也涉及空值。部分泛型映射提供了可选的空值检查器。处理接口或指针值时,调用方能明确哪些值应当视作 nil。官方示例用条件取值和写入演示了这种区别:检查规则不同,容器对某个值要不要写入的判断也可能不同。类型参数约束数据类型,空值检查则决定特定操作如何认定空值。
已有项目不必因为新增了泛型类型就一次换掉所有容器。依靠同一容器混放不同值类型的地方,未必适合直接改成单一值类型;使用自定义空值规则或共享访问的模块,也不能把换用泛型理解成自动开启并发保护。此次官网说明没有给出所有业务下的速度提升幅度,升级验证仍应以项目用到的容器接口、空值约定和并发选项为准。
版本源码截图许可:GoFrame MIT License。
Copyright (c) 2017 GoFrame Team https://goframe.org Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

















