Python中可迭代对象必须实现__iter__方法并返回迭代器;迭代器需同时实现__iter__(返回self)和__next__;推荐分离二者以支持多次迭代,避免状态干扰。

在 Python 中,一个对象要成为可迭代对象(iterable),关键在于它实现了 __iter__ 方法,并且该方法必须返回一个迭代器(iterator)对象——即实现了 __iter__ 和 __next__ 方法的对象。
可迭代对象的核心要求
只要类中定义了 __iter__ 方法,并返回一个具备迭代能力的对象(通常是自身或新创建的迭代器实例),该类的实例就能被用于 for 循环、list()、tuple() 等操作。
-
__iter__必须返回一个迭代器,不能返回普通值(如数字、字符串、列表等) - 返回的迭代器必须实现
__next__方法,控制每次取值逻辑 - 迭代器本身也必须实现
__iter__(通常返回self),以满足“迭代器也是可迭代对象”的协议
常见实现方式:自身作为迭代器
适用于逻辑简单、状态单一的场景,比如顺序遍历内部列表或生成固定序列。此时让类同时承担可迭代对象和迭代器的角色。
示例:
立即学习“Python免费学习笔记(深入)”;
class Countdown:
def __init__(self, start):
self.start = start
<pre class="brush:php;toolbar:false;">def __iter__(self):
return self # 返回自身
def __next__(self):
if self.start <= 0:
raise StopIteration
self.start -= 1
return self.start + 1
使用时:
Camoufox 是一个基于 Firefox 构建的开源反检测浏览器,为 Python 自动化工作流程提供强大的指纹注入和反机器人检测规避功能。它与 Playwright 集成,以提供能够绕过现代机器人检测系统的隐身浏览能力。
for i in Countdown(3): print(i) → 输出 3 2 1
推荐实现方式:分离可迭代对象与迭代器
更清晰、可复用性更高,尤其适合需要多次迭代、或状态需隔离的场景(例如多个 for 循环同时进行)。
- 可迭代对象的
__iter__每次调用都新建一个迭代器实例 - 迭代器类独立封装状态(如索引、游标),避免重复迭代时相互干扰
- 符合 Python 迭代协议的设计习惯,也便于调试和扩展
示例:
立即学习“Python免费学习笔记(深入)”;
class Numbers:
def __init__(self, data):
self.data = data
<pre class="brush:php;toolbar:false;">def __iter__(self):
return NumbersIterator(self.data) # 每次返回新迭代器class NumbersIterator: def init(self, data): self.data = data self.index = 0
def __iter__(self):
return self
def __next__(self):
if self.index >= len(self.data):
raise StopIteration
value = self.data[self.index]
self.index += 1
return value
注意点与易错情况
实际编码中容易忽略以下细节:
- 只实现
__iter__但返回的是列表等内置可迭代对象(如return self.items)——虽然能用,但不是自定义迭代器;若想完全控制迭代行为,仍应返回自定义迭代器实例 - 在
__iter__中直接用yield(即返回生成器函数),本质是返回生成器对象(它本身就是迭代器),这是一种简洁有效的替代写法 - 误在可迭代对象上实现
__next__而不配__iter__——这会让对象变成迭代器,但不再是“可迭代对象”,无法被多次for使用(因迭代器只能消耗一次)

















