range函数值遍历惰性序列

如果数据源本身就能逐项产生值，Go 1.23 以后不必先把结果装进完整切片，再交给 for range。只要函数值符合迭代器签名，就可以直接作为 range 表达式；循环体每消费一次，迭代器通过 yield 提供一次值，读者用 break 停止时，yield 会返回 false。

官方资料：https://go.dev/ref/spec#For_statements

版本说明：https://go.dev/doc/go1.23

这项能力的关键不是把任意函数塞进 range，而是让函数承担“按需提供序列”的职责，并严格遵守 yield 的返回值和函数签名。

函数值为什么能放进 range

传统的 range 右侧可以是切片、字符串、映射、通道或整数。Go 1.23 又增加了三种函数值形式：无值、单值和双值迭代器。它们的共同点是接收一个返回 bool 的 yield 回调。

也就是说，range 会准备一个内部的 yield，调用迭代器函数；每次 yield(v) 都对应循环体的一次消费。函数返回后，遍历结束。图1只表达这些静态边界，不是运行截图。

先写一个按需产出数字的迭代器

下面的函数只在消费者请求时提供偶数，没有预先创建完整结果切片。最重要的判断是 yield 的返回值：返回 false 时必须立即结束，不能继续调用它。

package main

import "fmt"

// EvenUpTo 按需产生小于 limit 的偶数。
func EvenUpTo(limit int) func(func(int) bool) {
	return func(yield func(int) bool) {
		for n := 0; n 

这里的“惰性”只表示结果按消费节奏逐项产生，不代表所有实现都零分配，也不自动保证更快。迭代器内部仍然可以访问文件、分页读取数据或遍历自定义容器，但资源关闭和错误传递要由自己的 API 设计负责。

让序列在业务边界保持清楚

当业务需要键和值时，可以使用双值形式。它适合表达带序号的记录、映射项或分页游标，但必须让两个值的含义稳定，避免为了凑成双值而传递无用字段。

// Pairs 将编号和名称按需交给调用方。
func Pairs(names []string) func(func(int, string) bool) {
	return func(yield func(int, string) bool) {
		for i, name := range names {
			if !yield(i, name) {
				return // 调用方提前结束时，不再访问后续元素
			}
		}
	}
}

// 使用两个循环变量接收键和值。
for index, name := range Pairs([]string{"Go", "Rust", "Java"}) {
	if index == 1 {
		break // 只消费前两项
	}
	_ = name
}

标准库的 iter.Seq[V] 和 iter.Seq2[K, V] 只是把这类函数签名命名化。团队接口可以直接使用这些类型，也可以保留具体函数签名；选择时优先考虑调用方是否容易读懂和复用。

版本和停止语义要提前处理

range-over-function 是 Go 1.23 的语言能力。旧模块如果语言版本低于 1.23，即使本机工具链较新，也可能不能按预期接受这段语法，应先检查并按项目策略调整 go.mod 的 go 行。

还要记住三个边界：

• 右侧必须是规范允许的三种函数签名，普通 func() int 不能直接作为 range 表达式。
• 迭代器调用 yield 后要检查布尔返回值；收到 false 就返回，不能继续 yield。
• 提前 break 只表示消费者不再需要后续值，不等于自动替你关闭文件、取消请求或回收外部资源。

可以把它理解为一条清晰的数据生命周期：数据源决定如何产生值，yield 定义生产者和消费者的边界，range 负责自然遍历，break 负责反馈停止。这样写出来的迭代器才既简洁，又不会把资源和控制流藏在循环语法之后。

常见问题

range 函数值会先生成完整切片吗？

不会由 range 自动生成完整切片。迭代器在调用 yield 时提供当前值，是否缓存、是否读取外部资源则取决于迭代器自己的实现。

为什么 yield 必须返回 bool？

这个返回值给消费者一个停止通道。循环体结束或执行 break 后，迭代器能收到 false，从而停止继续生产。