__iter__ 必须返回新迭代器而非 self，因可迭代对象与迭代器职责分离：前者负责生成，后者管理状态；否则多次遍历失败，违反pep 234契约。
为什么 __iter__ 返回迭代器，而不是直接返回 self
因为可迭代对象（Iterable）和迭代器（Iterator）在语义和生命周期上必须分离。常见错误是让类同时实现 __iter__ 和 __next__ 并在 __iter__ 里返回 self，这会导致多次遍历失败——比如在 for 循环、list()、sum() 中重复使用同一个对象时，第二次调用就直接空了。
正确做法是：每次调用 __iter__ 都新建一个独立的迭代器实例。这个迭代器内部持有当前状态（如索引、游标），而可迭代对象本身只负责“生成”它。
- 适用场景：
range、dict.keys()、自定义数据容器（如树、链表） - 性能影响：新建对象开销极小，远小于状态错乱带来的逻辑 bug
- 兼容性：符合 PEP 234，所有标准库函数（如
itertools.chain）都依赖这一契约
StopIteration 该由谁抛、什么时候抛
只能由迭代器的 __next__ 方法抛，且仅在“真的没有下一个元素”时抛。不能靠计数预判，也不能在初始化或 __iter__ 里抛。
常见错误包括：在 __next__ 开头就检查 if self.index >= len(self.data) 然后抛，但没处理空数据或边界变化；或者误把 IndexError 当 StopIteration 捕获并吞掉，导致无限循环。
立即学习“Python免费学习笔记（深入）”；
TAYGOD免费企业建站系统是一款开源的免费程序，您可以 TAYGOD免费企业建站系统ASP版是一款基于asp+access的免费开源建站系统。整套系统的设计构造，完全考虑中小企业类网站的功能要求，网站后台功能强大，管理简捷，支持模板机制，能够快速建立您的企业网站。 系统特性： 采用流行的asp+access设计，功能强，实用性高。 代码美工完全分离，维护更方便。 对运行环境要求低，基本上一般的
- 安全写法：在取值后立即判断是否越界，再决定返回还是抛
StopIteration - 不要在生成器函数里手动
raise StopIteration——return就够了，否则会触发RuntimeWarning - 协程或异步迭代器（
__aiter__/__anext__）中，对应抛的是StopAsyncIteration
如何让自定义类支持 in、len() 和解包而不重复实现
支持 in 查找靠 __contains__，支持 len() 靠 __len__，支持解包（如 a, b = obj）靠 __iter__。三者互不替代，也不能靠其中一个自动推导另一个。
典型坑是：只实现了 __iter__ 就以为 in 会自动变快——其实默认回退到逐个 __next__ 对比，时间复杂度 O(n)；而自己写 __contains__ 可以用哈希、二分或索引优化到 O(1) 或 O(log n)。
-
__len__必须返回非负整数，返回负数会引发ValueError - 解包要求对象可迭代且长度明确（否则报
ValueError: not enough values to unpack） - 如果底层数据支持快速查找（如
set或带索引的dict），别省那几行代码，直接实现__contains__
用生成器函数代替手写迭代器类真的更“工程”吗
绝大多数情况下是的，但前提是逻辑不依赖外部状态重入或并发访问。生成器函数（含 yield）本质是语法糖，Python 自动帮你管理了 __iter__ 和 __next__，还内置了状态挂起/恢复机制。
容易被忽略的点是：生成器对象不可重用。调用一次 list(gen()) 后，再次传给 sum(gen()) 就是空的——因为它不是可迭代对象，而是迭代器。所以若需要多次遍历，得包装一层类，或每次调用生成器函数重新创建。
- 适合场景：一次性数据流（日志行、API 分页结果）、简单变换（
map类逻辑） - 不适合场景：需暂停/恢复多个独立遍历（如双指针算法）、需共享内部缓存（如预加载下一页）
- 调试难点：生成器内部变量无法在暂停时 inspect，不如类属性直观
真正难的不是写对，而是想清楚“这个对象的生命周期归谁管”——是调用方每次要新拿一个，还是它自己能反复交出新迭代器。这点一旦错，下游所有 for、list()、itertools 组合都会静默失效。
