Go标准库无iter包，import "iter"必报错；正确路径为golang.org/x/exp/iter（实验版）或github.com/clipperhouse/iter（第三方），二者API不兼容。
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) 的整数：
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 < to; i++ {
if i%2 == 1 {
if !yield(i) {
return false
}
}
}
return true
}
}
// 使用：
for n := range OddNumbers(0, 10) {
fmt.Println(n) // 输出 1 3 5 7 9
}
- 关键点：函数返回值类型必须是
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
}
}
- 这种结构体可自由添加字段和方法（如
it.Reset()重置游标），灵活性远高于iter.Seq函数式风格 - 注意：它不兼容
for range语法，除非额外包装成iter.Seq函数（用闭包调用Next()） - 并发不安全：多个 goroutine 同时调用
Next()会竞争current字段，需加锁或改用 channel
真正难的不是写一个能跑的迭代器，而是决定状态该存在闭包里还是结构体里、是否要支持中断恢复、要不要隐藏底层数据源细节——这些设计选择，比语法本身影响更大。
