当前位置：首页 > 文章列表 > Golang > Go问答 > Go iter.Seq 如何把回调迭代接入 range：yield、提前停止与错误传递

Go iter.Seq 如何把回调迭代接入 range：yield、提前停止与错误传递

来源：17golang原创 2026-08-29 18:33:34 0浏览收藏

把一个分页读取器改成可组合的迭代器时，最容易卡住的不是语法，而是没看清谁拥有“继续”和“停止”的决定权。Go 1.23 的 range 可以直接消费 iter.Seq，但数据库读取、提前 break 和错误返回仍然要由代码明确安排。

yield 返回 false 就表示消费方已经停止；迭代器必须立刻收尾，错误则不能藏在布尔返回值里，应该通过结果值或闭包状态显式带出来。

要点速览

iter.Seq[V] 的核心签名是把每个值交给 yield。
循环体里的 break 会让后续 yield 返回 false，生产端要据此退出。
迭代器的布尔返回值用于组合控制，不等同于业务错误。
需要错误时，用 readItems 保存 err，消费结束后再检查。

先把 iter.Seq 的控制权分清

iter.Seq[V] 可以理解为“接收一个 yield 函数，并负责按顺序调用它”。下面的实现故意保留最小状态：生产端只决定读什么，消费端决定要不要继续。

package main

import "iter"

func numbers() iter.Seq[int] {
    return func(yield func(int) bool) bool {
        for n := 1; n

这里的 range 调用 numbers，numbers 再调用 yield。当循环执行 break，运行时会让当前的 yield 返回 false；因此生产端的 return false 是必要的收尾分支。若忽略这个返回值，分页读取器可能在调用方已经不需要数据时继续读。

iter.Seq、range、yield 与 break 的真实控制流：range 调用 iter.Seq，yield 返回 false 后 break 让生产端退出

把分页读取放进生产端，错误单独走一条路径

实际项目通常不是生成 1 到 5，而是循环读取一页数据。下面用 readItems 表示已有的分页读取函数；它返回当前页和错误。错误不应借用 yield 的 false 来伪装，因为 false 也可能只是正常的提前停止。

func items(readItems func() ([]string, error)) (iter.Seq[string], *error) {
    var err error
    seq := func(yield func(string) bool) bool {
        for {
            page, readErr := readItems()
            if readErr != nil {
                err = readErr
                return false
            }
            if len(page) == 0 {
                return true
            }
            for _, item := range page {
                if !yield(item) {
                    return false
                }
            }
        }
    }
    return seq, &err
}

这个示例把 err 放在迭代器外层，便于调用方在循环后检查。生产端遇到 yield 返回 false 时直接结束；读取失败时先写入 err 再结束，二者的来源不同，排查时不会把“用户只要前两条”和“数据库读取失败”混成一个结果。

readItems、err、yield 与 stop 的数据路径：读取页后交给 yield，读取错误写入 err，stop 后结束生产端