如何利用Python的__iter__与__next__使类支持for循环迭代？-Python教程-PHP中文网

直接写__iter__和__next__比yield更值得细究，因需维护状态、支持多次遍历或精细控制流程；__iter__须返回含__next__的对象（常为self），__next__必须显式raise stopiteration，且判断逻辑应先取值再推进状态最后判停。

如何利用python的__iter__与__next__使类支持for循环迭代？

为什么直接写 `iter` 和 `next` 比用 `yield` 更值得细究？

因为不是所有迭代场景都适合生成器。当你需要在迭代过程中维护状态（比如计数、缓存、资源句柄），或需多次遍历同一实例，__iter__ 返回自身 + __next__ 手动控制流程，比依赖 yield 的单次生成器更可控。

常见错误是让 __iter__ 返回 self 却忘了在 __next__ 里抛出 StopIteration —— 这会导致 for 循环无限卡住。

__iter__ 必须返回一个实现了 __next__ 方法的对象（通常是 self）
__next__ 在无更多元素时必须显式 raise StopIteration，不能靠 return 或静默退出
如果类要支持多次遍历（如 list 那样），__iter__ 不应复用自身状态，而应每次返回新迭代器实例

`next` 抛 `StopIteration` 的时机和位置很关键

很多初学者把判断逻辑放在 __next__ 开头，结果第一次调用就抛异常，导致空循环；或者放在末尾但没处理边界，漏掉最后一个元素。

正确做法是：先取当前值，再推进状态，最后判断是否该停。这样能保证每个有效元素都被返回一次。

class Countdown:
    def __init__(self, n):
        self.n = n
<pre class="brush:python;toolbar:false;">def __iter__(self):
    return self

def __next__(self):
    if self.n <= 0:  # 判断「下一个」是否还存在
        raise StopIteration
    val = self.n
    self.n -= 1
    return val

注意：if self.n 是在取值前判断，确保不会多返回一次 <code>0 或负数。

Python 3.14.2

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

下载

如何让同一个对象支持多次 `for` 循环？

上面的 Countdown 类一旦被遍历过一次，self.n 就变成 0，再次 for 就直接抛 StopIteration。这不是 bug，而是设计选择——它像文件对象（只能读一次）。若要像 list 那样可重复遍历，得把迭代状态从类本身剥离。

让 __iter__ 每次返回一个新迭代器对象（比如内部定义的 Iterator 类）
不要在主类里存迭代用的游标变量（如 self.n），改由迭代器实例持有
主类只负责「生成」迭代器，不参与「执行」迭代

class Countdown:
    def __init__(self, n):
        self.n = n
<pre class="brush:python;toolbar:false;">def __iter__(self):
    return CountdownIterator(self.n)

class CountdownIterator: def init(self, n): self.n = n

def __next__(self):
    if self.n <= 0:
        raise StopIteration
    val = self.n
    self.n -= 1
    return val

def __iter__(self):
    return self