Go iter.Pull2 如何在提前结束时释放迭代器

用 iter.Pull2 消费键值迭代器时，最容易漏掉的是生命周期：循环提前 break，并不等于底层迭代器函数已经自然返回。正确写法是拿到 next 和 stop 后立刻执行 defer stop()。这样无论是提前退出，还是 next 已经返回 ok=false，都能让迭代器完成收尾。

iter.Pull2 返回的接口如何理解

iter.Seq2[K,V] 是“推送式”迭代器：它把 k、v 交给 yield。iter.Pull2 将它转换成“拉取式”接口，返回 next func() (K, V, bool) 和 stop func()。调用方自己决定什么时候取下一项，也自己负责结束生命周期。

提前 break 时为什么必须调用 stop

当 next 尚未返回 false，迭代器函数可能仍停在 yield 附近，或者还持有由迭代器代码管理的文件、锁和临时状态。stop 会让这条迭代链结束，使迭代器函数有机会从调用点返回，进而执行它自己的 defer 清理逻辑。

这里的“释放”不是强制触发垃圾回收，也不是把 next 变成一个关闭方法；它指的是明确结束迭代协作。官方约定是：只要调用方对后续值不再感兴趣，且 next 还没有报告序列结束，就必须调用 stop。即使已经自然耗尽，重复调用 stop 也是合法的，所以统一 defer 最稳妥。

用 defer stop() 覆盖正常和提前退出

下面的例子模拟读取成绩记录：遇到不及格项就提前离开。关键点不是某个业务条件，而是 stop 与消费逻辑处于同一层作用域。

package main

import (
    "fmt"
    "iter"
)

// records 用 Seq2 产生键值对；yield 返回 false 就停止继续产生。
func records() iter.Seq2[string, int] {
    return func(yield func(string, int) bool) {
        rows := []struct {
            name  string
            score int
        }{{"甲", 86}, {"乙", 72}, {"丙", 58}, {"丁", 91}}
        for _, row := range rows {
            // 把业务记录交给 Pull2 的内部桥接函数。
            if !yield(row.name, row.score) {
                return
            }
        }
    }
}

func main() {
    next, stop := iter.Pull2(records())
    // break、return 或自然耗尽都会经过这里。
    defer stop()

    for {
        name, score, ok := next()
        // ok=false 时，name 和 score 是各自类型的零值。
        if !ok {
            break
        }
        fmt.Println(name, score)
        if score 

如果消费到 丙 就退出，stop 会在 main 返回前执行；如果一直读到末尾，next 会返回 false，同一个 stop 仍然可以安全执行。实际项目中可以把 Pull2 放进更小的函数，让 defer 的生命周期不要覆盖不必要的后续工作。

几个容易误用的边界

第一，不要把 next 和 stop 分别交给不同 goroutine 同时调用。iter.Pull2 明确禁止这种并发访问；如果业务需要并发，应在单一消费者内部读取，再通过 channel 或其他并发安全结构转发。

第二，拿到 ok=false 后可以继续调用 next，结果仍会是零值和 false；调用过 stop 后也遵循同样的终止语义。它们是容错边界，不是鼓励继续轮询的信号。

第三，迭代器本身要尊重 yield 的布尔返回值。生成端忽略 false 还继续调用 yield，会破坏 Pull2 的协作约定。把 if !yield(...) { return } 写在生成端，和消费端的 defer stop() 同样重要。

常见问题

next 返回 false 后还需要 stop 吗？

建议保留 defer。自然耗尽后重复调用 stop 合法，统一写法可以覆盖未来新增的提前 return，也不用让每个分支单独维护清理逻辑。

stop 能不能替代关闭文件或数据库连接？

不能直接替代。stop 只负责结束迭代协作；文件、连接等资源仍应在迭代器函数内部用对应的关闭或释放逻辑处理，通常也是 defer。

为什么不直接用 range？

range 更适合顺序消费完整序列；需要逐项拉取、在两个值之间做判断，或把消费节奏交给调用方时，Pull2 才有意义。若只是普通遍历，优先使用 range 表达意图。