Go 1.23 的 range over func 怎么写：yield 返回 false 后为什么必须停

给自定义容器加遍历能力时，过去常见的做法是暴露回调、通道，或者把数据先攒成切片。Go 1.23 以后，满足特定签名的函数可以直接放进 for range。最容易漏掉的一条规则是：循环提前结束后，yield 会返回 false；迭代函数必须立刻收尾，不能继续推送下一个值。

先记住最小写法：只要把停止信号传回去

对一串整数做筛选时，不必先创建新的结果切片。下面的函数返回 iter.Seq[int]，调用方用普通的 for range 消费它。关键只有一行：!yield(v) 成立时马上返回。

package main

import (
	"fmt"
	"iter"
)

func Positive(values []int) iter.Seq[int] {
	return func(yield func(int) bool) {
		for _, v := range values {
			if v 

这段代码会打印 1 和 3。循环里的 break 会让合成的 yield 回报 false，于是 Positive 不再处理后面的 5。这就是它比“把回调当作普通函数”更需要遵守的停止契约。

为什么旧式回调不能原样搬过来

很多项目原本已经有了推送式遍历方法，问题不在于能不能逐个给值，而在于调用端想提前离开循环时，生产方如何知道该停。若旧回调没有布尔返回值，外层的 break 无法自然回传到数据生产处，遍历还会继续跑完。

这里别把 false 当成“当前元素无效”。它表达的是“消费者不再需要后续元素”。如果迭代函数无视这个结果，循环已经退出后还继续调用 yield，运行时会以 panic 暴露这个违反约定的行为。

range 只接受三种函数形状

range over func 不是任意函数都能用。外层函数只接收一个 yield 参数，而 yield 可产生 0、1 或 2 个循环变量，并且必须返回布尔值。零值形状不常见，一值和键值对是日常最实用的两种。

func(yield func() bool)
func(yield func(V) bool)
func(yield func(K, V) bool)

标准库用 iter.Seq[V] 表示一值序列，用 iter.Seq2[K, V] 表示双值序列。比如包装索引和值时，可以返回 iter.Seq2[int, string]；消费端自然写成 for i, name := range names。不需要为了一次简单遍历额外引入自定义接口。

把旧写法改成迭代函数时，先保留资源收尾

迭代器内部若只有切片循环，遇到 false 后返回已经足够。若内部会读取文件、占用连接或启动后台工作，则停止分支同样是资源收尾点。先把关闭逻辑放在函数返回路径上，再检查每一次 yield 调用后都能走到该路径。

func Visit(rows []string) iter.Seq[string] {
	return func(yield func(string) bool) {
		for _, row := range rows {
			if !yield(row) {
				return
			}
		}
	}
}

对于需要手动逐项取值的场景，可以用 iter.Pull 把序列转换成取值函数；那时应在不再读取时调用返回的停止函数。普通 for range 不需要额外写这一步，因为语言会在循环提前退出时把停止信号交给 yield。

兼容性先看 go.mod，再决定能否公开采用

这个语法属于 Go 1.23 的语言特性，仅升级本机工具链还不够；模块也应声明至少 1.23 的语言版本。先在分支里改动一处小范围代码，跑完测试后再决定是否把它放到对外库的公共路径。

module example.com/catalog

go 1.23

如果库仍承诺支持 Go 1.22 或更早版本，调用方的构建工具无法解析这种 for range 用法。更稳的选择是继续保留切片、普通回调或通道形式，等最低支持版本统一后再切换。内部服务可以先采用，但持续集成最好同时校验 go.mod 声明和实际构建版本。

采用前做这四项小检查

1. 确认所有 yield 调用都检查返回值，遇到 false 不再继续生成元素。
2. 为循环内的 break、return 和完整消费各写一条测试，观察生产方的收尾路径。
3. 把模块语言版本设为 go 1.23，并用目标工具链运行 go test ./...。
4. 若代码是公共库，先核对支持矩阵；不能要求使用方升级时，保留旧的遍历入口。

相关问题

可以让迭代函数返回 error 吗？

不能把 error 放在这三种允许的函数形状里。通常做法是让迭代器闭包捕获错误状态，或提供单独的错误查询方式；需要逐步处理错误时，普通回调或其他 API 可能更直观。

for range 提前 break 后，为什么还会看到 panic？

常见原因是生产方在 yield 已返回 false 后仍继续调用它。检查每个调用点是否都有 if !yield(...) { return }。

iter.Seq 和通道谁更适合流式数据？

单线程顺序遍历时，iter.Seq 往往更直接；跨并发边界传递数据时，通道仍然有其同步语义。不要只为替换语法而改掉已有的并发协议。

只有编译器是 Go 1.23，go.mod 还是 1.22 能写吗？

不行。range over func 需要至少 Go 1.23 的语言版本声明；把 go.mod 一起更新，才能让本地与持续集成采用一致的语言规则。