如何在 Go 中使用 iter 包构建自定义迭代器-Golang-PHP中文网

go标准库无iter包，import "iter"必报错；正确路径为golang.org/x/exp/iter（实验版）或github.com/clipperhouse/iter（第三方），二者api不兼容。

如何在 go 中使用 iter 包构建自定义迭代器

Go 标准库没有 iter 包 —— 你看到的很可能是第三方库（如 github.com/clipperhouse/iter）或 Go 1.23+ 实验性 iter 包（尚未稳定，未进入标准库）。 直接 import "iter" 会报错 import "iter": cannot find package，这是最常卡住的第一步。

为什么 `import "iter"` 报错：区分实验包与第三方实现

Go 官方在 1.23 中引入了实验性 iter 包（路径为 golang.org/x/exp/iter），但它不是标准库，需显式 go get golang.org/x/exp/iter；而更早流行的 clipperhouse/iter 是独立第三方，API 完全不同。混淆两者会导致编译失败或行为异常。

检查你代码里 import 的路径："iter" ❌、"golang.org/x/exp/iter" ✅（实验版）、"github.com/clipperhouse/iter" ✅（第三方）
Go 1.23 默认不启用实验包，需加 GOEXPERIMENT=loopvar 环境变量（仅对部分特性必要，iter 包本身只需正确导入）
golang.org/x/exp/iter 仅提供基础迭代器构造函数（如 Range、Repeat），不支持自定义迭代器类型；真正需要“构建自定义迭代器”，得靠手动实现 Iterator[T] 接口（即含 Next() 方法的结构体）

用 `golang.org/x/exp/iter` 实现简单范围迭代（非自定义，但常被误认为起点）

这个包适合快速生成常见迭代器，但无法封装业务逻辑。比如想迭代 [10, 20) 的整数：

使用Go语言搭建家庭相册系统-相关课件

下载

import "golang.org/x/exp/iter"

func main() {
	iter := iter.Range(10, 20) // 返回 iter.Seq[int]
	for v := range iter {
		fmt.Println(v) // 输出 10 到 19
	}
}

iter.Range(start, end) 返回的是 iter.Seq[T] 类型，本质是 func(yield func(T) bool)，不是结构体实例，无法附加状态或方法
它不满足“自定义迭代器”的典型需求：比如带过滤、带缓存、访问外部资源、维护游标位置等
若强行在此基础上“扩展”，只能靠闭包捕获变量，可读性和复用性差

手动实现符合 `iter.Seq[T]` 签名的自定义迭代器（Go 1.23+ 推荐方式）

真正可控的自定义，是写一个函数，签名匹配 func(func(T) bool) bool。例如实现一个跳过偶数的整数迭代器：

func OddNumbers(from, to int) iter.Seq[int] {
	return func(yield func(int) bool) bool {
		for i := from; i

关键点：函数返回值类型必须是 iter.Seq[T]，内部用 yield 控制逐个产出，yield 返回 false 表示提前终止（如 break）
状态（如当前索引、缓存项）应放在闭包内，而非函数参数——参数只用于初始化，迭代过程中的变化靠闭包变量维持
不要试图在 yield 前做耗时操作（如网络请求），因为调用方可能只取前几项，导致多余开销

兼容旧版本 Go 或需要复杂状态管理时，直接实现传统迭代器结构体

如果项目还在用 Go 1.22 或以下，或需要暴露 Reset()、Peek() 等方法，就绕过 iter 包，自己定义：

type IntIterator struct {
	start, end, current int
}

func (it *IntIterator) Next() (int, bool) {
	if it.current >= it.end {
		return 0, false
	}
	val := it.current
	it.current++
	return val, true
}

// 使用：
it := &IntIterator{start: 5, end: 8}
for {
	if v, ok := it.Next(); ok {
		fmt.Println(v)
	} else {
		break
	}
}