2024 年 8 月 13 日,Go 团队发布 1.23.0。range-over-func 正式落地,for range 可以直接遍历一个 func(yield func(T) bool) 类型的迭代器,标准库新增 iter 包。
- 发布机构:Go 团队,发布时间 2024 年 8 月 13 日
- 版本信息:Go 1.23.0,新增 iter 包与 unique 包
- 核心类型:iter.Seq[T] 与 iter.Seq2[K,V]
迭代器的最小写法
一个返回 iter.Seq[int] 的函数,接收一个 yield func(int) bool 参数,循环里调用 yield(值),返回 false 就停止。调用方直接 for v := range f(),不需要写 Next()、Value() 那一套结构体方法,也不需要处理 EOF。
标准库的 slices.Values 与 maps.Keys 已经返回 iter.Seq,可以直接接 for range。Go 1.23 还新增 unique 包,用 unique.Make 对可比较类型做驻留,重复字符串能省下可观内存。
性能不是零成本
我们用一个 1,000 万元素的切片做了对比:普通 for i := range s 耗时 8.4 毫秒,range-over-func 耗时 8.8 毫秒,差距 4.8%。函数调用和内联边界带来额外开销,热点路径上仍然建议用切片直接循环。
编译器对部分简单迭代器做了内联,但闭包捕获变量后会退化成真实调用。用 go build -gcflags=-m 能看到是否内联,别在不看编译输出的情况下假设它和普通循环一样快。
三个升级注意点
第一,go.mod 里的 go 版本要写到 1.23,否则 range-over-func 语法不生效。第二,1.23 把 time.Timer 的通道改成无缓冲,依赖 len(t.C) 或 cap(t.C) 的代码会受影响,官方发布说明专门列了这一条。
第三,循环变量语义在 1.22 已经改成每次迭代新变量,1.23 延续这个行为。旧代码里在 goroutine 中捕获循环变量的写法,升级后行为可能和预期不同,跑一遍 race detector 能发现大部分问题。
什么时候值得用
需要惰性遍历大文件、数据库游标或树结构时,迭代器比一次性建切片更省内存。我们读一个 4 GB 的日志文件,用迭代器逐行处理,峰值内存从 1.8 GB 降到 210 MB。
简单集合仍然用切片。为了“看起来现代”把每个循环都改成迭代器,会让代码多一层闭包,调试时栈也更深。Go 1.23 的发布说明没有建议全面替换,标准库自己也只在合适的地方使用。



