golang range over func迭代器用法详解

Go 1.23 引入了对 `range over func` 的原生支持，但并非任意函数都能被遍历，而是严格要求函数签名必须为 `func(yield func(T) bool)`（标准库已通过 `iter.Seq[T]` 提供清晰别名），其核心价值在于实现轻量、可控、按需拉取的迭代逻辑——尤其适合分页数据库查询等场景：避免全量加载、消除 goroutine 和 channel 带来的并发复杂性与资源泄漏风险；正确用法是将数据获取（如 SQL 查询）置于 `yield` 调用内部，配合闭包状态管理分页偏移与缓存，失败时直接 `return` 终止迭代，同时需警惕常见陷阱——如误在 `yield` 外预加载数据、忽略 `yield` 返回值导致死循环、或混淆旧版 `(T, bool)` 签名而编译失败；更重要的是，迭代器本身不管理资源生命周期，DB 连接、文件句柄等必须由调用方显式释放，这让它既强大又需要更精准的工程意识。

Go 1.23+ 中 range 能直接遍历函数，但必须是 func(yield func(T) bool) 类型

Go 1.23 正式支持 range over func，但它不是“任意函数都能 range”，而是有严格签名要求：必须接受一个 yield 回调，且返回 bool 控制是否继续。编译器靠这个签名识别迭代器，不是靠名字或注释。

• yield 是你写循环体的地方——for v := range it 的 v 就是它传进来的值；返回 false 表示提前退出（比如用户按 Ctrl+C、条件满足、资源不足）
• 别写成 func() T 或 func() (T, bool) ——那是 Go 1.22 试验期的旧模式，1.23 已弃用，强行用会报错 cannot range over ... (type func() (int, bool))
• 标准库已提供类型别名：iter.Seq[T] 就是 func(func(T) bool) 的可读写法，建议直接用，避免手写冗长签名

用 iter.Seq 写分页数据库迭代器，比 channel 更轻、更可控

以前用 chan 做分页拉取，得开 goroutine、关 channel、防死锁；现在用 iter.Seq，纯同步、无并发、状态全在闭包里，出错不 panic，退出不泄漏。

• 典型错误：在 yield 外部做 DB 查询，导致每次 range 迭代都重查整页（性能崩）；正确做法是把 offset 和缓存切片作为闭包变量，在 yield 内部按需填充
• 示例中 db.QueryRow 或 db.Select 必须在 yield 循环体内触发，而不是在函数开头一次查完——这才是“按需拉取”的本意
• 如果 DB 查询失败，直接 return 即可，yield 不会被调用，range 自然结束；无需 panic 或显式错误返回

func UserIDs(db *sql.DB, limit int) iter.Seq[int64] {
	offset := 0
	return func(yield func(int64) bool) {
		for {
			var ids []int64
			err := db.Select(&ids, "SELECT id FROM users ORDER BY id LIMIT ? OFFSET ?", limit, offset)
			if err != nil || len(ids) == 0 {
				return // 迭代终止
			}
			for _, id := range ids {
				if !yield(id) { // 用户中途 break，立刻退出
					return
				}
			}
			offset += limit
		}
	}
}

组合多个迭代器时，别直接嵌套 range，要用 iter.Map 或手写包装

想对每个用户 ID 查详情再处理？别写 for id := range UserIDs(...) { for detail := range GetUserDetail(id) { ... } }——这会变成 N+1 查询，且无法用 iter 工具链统一控制。

• 标准库 iter.Map 接收 iter.Seq[A] 和转换函数，返回新的 iter.Seq[B]，天然支持链式调用
• 手动包装更灵活：比如加日志、限流、重试，只要新函数仍符合 func(yield func(T) bool) 签名即可
• 注意泛型推导：如果 UserIDs 返回 iter.Seq[int64]，而 GetUserDetail 需要 int，记得显式类型转换或用 iter.Map 投影，否则编译报错 cannot use ... as iter.Seq[int] value in argument

调试时卡死或没输出？先检查 yield 是否被调用、是否永远返回 true

最常见的现象是 for v := range it 一行不输出、程序挂住，或者只跑一次就退出——大概率是 yield 根本没被调，或逻辑写反了。

• 在 yield 调用前加 fmt.Println("about to yield", x)，确认执行流走到那里；如果没打印，说明前面查询为空、条件提前 return、或 offset 错位跳过所有数据
• 如果 yield(x) 总是返回 true，但你的逻辑本应终止（比如查到某字段为 null），就会无限循环；务必检查 yield 返回值并响应它
• 不要在 yield 内部 recover panic——它不是 error handler，panic 会直接向上冒泡；真要容错，应在 yield 外层做 defer 清理，或改用带 error 的封装层

最易被忽略的一点：迭代器函数本身不持有任何“生命周期”语义，它不自动关闭 DB 连接、不释放文件句柄、不 cancel context。这些必须由调用方显式管理——range 结束 ≠ 迭代器销毁。

今天关于《golang range over func迭代器用法详解》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！