Go1.22range函数迭代器使用详解

一分耕耘，一分收获！既然打开了这篇文章《Go 1.22 range func 迭代器使用教程》，就坚持看下去吧！文中内容包含等等知识点...希望你能在阅读本文后，能真真实实学到知识或者帮你解决心中的疑惑，也欢迎大佬或者新人朋友们多留言评论，多给建议！谢谢！

Go 1.22 的 range 迭代器是 range 语句对函数返回迭代器的扩展，要求函数返回 func() (T, bool) 类型；编译器自动展开为循环，适用于懒加载、分页等场景。

Go 1.22 引入的 range 函数迭代器（即支持对函数返回的迭代器进行 range）不是新语法，而是语言对 range 语句的扩展：只要函数返回符合迭代器协议的类型（两个返回值：元素、布尔值），就能直接用 range 遍历。它让业务代码更简洁、更声明式，尤其适合懒加载、分页、流式处理等场景。

写一个符合 range 协议的迭代器函数

核心是返回一个函数，该函数每次调用返回 value, ok —— 类似 map 或 channel 的迭代行为。Go 编译器会自动识别并展开为循环。

例如，实现一个从数据库分批拉取用户 ID 的迭代器：

func UserIDsIterator(db *sql.DB, batchSize int) func() (int64, bool) {
    rows := make(chan int64, batchSize)
    go func() {
        defer close(rows)
        offset := 0
        for {
            var ids []int64
            err := db.Select(&ids, "SELECT id FROM users ORDER BY id LIMIT ? OFFSET ?", batchSize, offset)
            if err != nil || len(ids) == 0 {
                return
            }
            for _, id := range ids {
                rows <p>使用时直接 <code>range</code>：</p><pre class="brush:php;toolbar:false;">for id := range UserIDsIterator(db, 100) {
    // 处理单个用户 ID
    processUser(id)
}

避免常见陷阱：状态与并发安全

迭代器函数内部需自行管理状态（如游标、缓冲、关闭逻辑）。若涉及 goroutine + channel，注意资源泄漏和 panic 传播。

• 不要在迭代器闭包中直接访问外部可变变量（如循环变量 i），应捕获副本
• 如果迭代器依赖外部资源（如 DB 连接、文件句柄），确保在迭代结束或出错时释放
• 不建议在迭代器函数里启动长期 goroutine；更适合“按需拉取”，比如每次调用生成下一批数据

业务常用模式：分页、过滤、转换

把通用逻辑封装成可组合的迭代器，提升复用性：

// 分页包装器
func Paginate[T any](fetcher func(offset, limit int) ([]T, error), limit int) func() (T, bool) {
    offset := 0
    var cache []T
    var cacheIdx int
    return func() (T, bool) {
        if cacheIdx >= len(cache) {
            cache, _ = fetcher(offset, limit)
            if len(cache) == 0 {
                var zero T
                return zero, false
            }
            cacheIdx = 0
            offset += limit
        }
        v := cache[cacheIdx]
        cacheIdx++
        return v, true
    }
}
<p>// 使用：遍历所有订单（自动分页）
for order := range Paginate(db.FetchOrders, 50) {
sendNotification(order)
}</p>

何时不用 range 迭代器？

不是所有场景都适合。简单切片、已知长度集合、性能敏感内层循环，仍优先用传统 for i := range 或 for _, v := range。

• 迭代器有额外函数调用开销，微秒级场景需实测
• 调试困难：无法直接打印中间状态，也不支持 break 后继续（除非自己维护状态）
• 错误处理弱：协议只返回 ok，不暴露错误详情；需在迭代器内部记录日志或 panic

到这里，我们也就讲完了《Go1.22range函数迭代器使用详解》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！