如何在Python中通过__iter__和__next__实现自定义迭代器？-Python教程-PHP中文网

必须同时实现__iter__和__next__，且__iter__须返回自身或新迭代器；若仅返回self而不重置状态，多次遍历会失败；__next__必须显式raise stopiteration，不可用return终止。

如何在python中通过__iter__和__next__实现自定义迭代器？

直接说结论：必须同时实现 __iter__ 和 __next__，且 __iter__ 必须返回自身（或另一个迭代器对象），否则 for 循环会报 TypeError: 'X' object is not iterable。

为什么 `iter` 不能只返回 `self` 就完事？

很多初学者写完 __iter__(self): return self 就以为搞定了，结果发现多次遍历失败——比如在同一个对象上连续执行两次 for 循环，第二次直接空跑。这是因为迭代器协议要求：迭代器对象本身必须可被 iter() 调用，且每次调用都应返回一个“新鲜的”迭代状态。如果 __iter__ 总是返回 self，而 __next__ 又修改了内部状态（如索引 self._i += 1），那第二次遍历就会从上次中断处继续，甚至直接抛 StopIteration。

解决办法是让 __iter__ 返回一个新的迭代器实例，或者在 __iter__ 中重置状态：

推荐做法：在 __iter__ 里重置计数器（如 self._i = 0），再返回 self —— 简单、符合直觉，适用于单次使用场景
更严谨做法：把迭代逻辑拆到独立类中，__iter__ 每次都 return IteratorClass(self.data) —— 支持多路并发遍历，比如两个 for 循环同时跑

`next` 必须手动抛 `StopIteration`，不能靠 `return`

这是最常踩的坑：__next__ 函数末尾没写 raise StopIteration，或者用 return None 代替，会导致无限循环或静默失败。Python 迭代协议明确规定：迭代结束的唯一信号是 StopIteration 异常，return 任何值（包括 None）都会被当作有效元素返回。

典型错误写法：

Python 3.14.2

Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。

下载

def __next__(self):
    if self._i >= len(self.data):
        return  # ❌ 错！这会让 for 循环永远卡住

正确写法：

def __next__(self):
    if self._i >= len(self.data):
        raise StopIteration  # ✅ 唯一合法的终止方式
    item = self.data[self._i]
    self._i += 1
    return item