Python迭代器协议：\_iter\_实现全解析

本文深入解析了Python迭代器协议的核心——`__iter__`方法的正确实现逻辑与设计哲学，阐明它并非直接返回元素，而是必须返回一个符合协议的迭代器对象，从而清晰分离“可迭代性”与“遍历状态”；文章系统梳理了委托内置迭代器、返回自身（需配套`__next__`）、返回生成器这三种主流实现模式，并揭示了`__iter__`与`__next__`的协作本质：前者负责开启迭代，后者驱动逐项产出，且必须以`StopIteration`异常而非返回值来标识结束——掌握这些细节，才能写出健壮、可重用、真正符合Python惯用法的可迭代对象。

Python迭代器协议是一套约定，规定了对象如何被 for 循环、list()、next() 等内置操作识别和使用——核心是实现 __iter__ 和（通常）__next__ 两个特殊方法。

__iter__ 方法的作用

__iter__ 是迭代器协议的入口方法，必须返回一个**迭代器对象**（即实现了 __next__ 方法的对象）。它不负责逐个返回元素，只负责“提供能迭代的东西”。

• 如果对象本身已是迭代器（如自定义类既要可迭代又要记录当前状态），__iter__ 通常直接返回 self
• 如果对象是容器（如列表、字典），__iter__ 一般返回其内部数据的迭代器，例如 return iter(self._data)
• 不能返回普通值（如数字、字符串本身），也不能返回生成器函数（需调用后才得生成器对象）；但可以返回生成器函数的调用结果：return self._gen()（其中 _gen 是带 yield 的函数）

为什么 __iter__ 返回迭代器，而不是直接返回元素？

这是为了分离“可迭代对象”和“迭代器”的职责。前者表示“能被遍历”，后者表示“正在遍历的状态”。比如一个列表可被多次遍历，每次 for 都调用 __iter__ 得到一个新迭代器，互不影响。

• 若 __iter__ 错误地返回元素（如 return self._items[0]），会触发 TypeError: iter() returned non-iterator
• 若返回自身但没实现 __next__，调用 next(iter(obj)) 会报 TypeError: 'X' object is not an iterator

常见实现模式

有三种典型写法，按场景选择：

• 委托给内置迭代器：适合封装容器，简洁安全
  def __iter__(self): return iter(self._items)
• 返回自身 + 实现 __next__：适合需要维护遍历状态的迭代器类
  def __iter__(self): return self，并在类中定义 __next__(self) 控制逻辑
• 返回生成器：最常用、最简洁的惰性计算方式
  def __iter__(self): yield from self._items 或 def __iter__(self): for x in self._items: yield x

与 __next__ 的配合关系

__iter__ 只管“开局”，真正逐个产出元素靠 __next__。每次调用 next(iterator) 就触发一次 __next__；当无更多元素时，__next__ 必须抛出 StopIteration 异常——这是迭代结束的唯一合法信号。

• 不能靠返回 None 或特殊值标记结束，否则 for 循环不会停止
• 生成器函数自动处理 StopIteration，所以用 yield 实现时无需手动抛出

到这里，我们也就讲完了《Python迭代器协议：\_iter\_实现全解析》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！