本教程深入探讨Python中可重用迭代器的实现机制，特别关注如何构建一个行为与内置`range`函数相似的自定义类。我们将分析简单生成器函数为何不可重用，并演示如何通过定义一个包含`__iter__`方法的类来创建可多次迭代的对象，从而解决自定义序列在多次遍历后变为空的问题。
Python迭代器与生成器基础
在Python中，迭代是核心概念之一。一个对象如果可以被迭代，就称为“可迭代对象”（Iterable）。可迭代对象通常通过实现__iter__方法来返回一个“迭代器”（Iterator）。迭代器是真正负责按顺序生成元素的工具，它通过实现__next__方法来返回序列中的下一个元素，并在序列耗尽时抛出StopIteration异常。
生成器函数是创建迭代器的一种简洁方式。当一个函数包含yield关键字时，它就成为了一个生成器函数。调用生成器函数会返回一个生成器对象，这个对象本身就是一个迭代器。
简单生成器函数的局限性
考虑一个自定义的生成器函数，它旨在模仿range的行为：
立即学习“Python免费学习笔记（深入）”；
def exampleCustomRange(stopExclusive):
for i in range(stopExclusive):
yield i
# 使用内置的range进行对比
builtinRange = range(3)
print(f"内置range第一次遍历: {[x for x in builtinRange]}")
print(f"内置range第二次遍历: {[x for x in builtinRange]}") # 可以重复遍历
# 使用自定义生成器函数
customRange = exampleCustomRange(3)
print(f"自定义生成器第一次遍历: {[x for x in customRange]}")
print(f"自定义生成器第二次遍历: {[x for x in customRange]}") # 第二次遍历为空从上面的输出可以看出，builtinRange可以被多次遍历并每次都产生相同的序列，而customRange在第一次遍历后就“耗尽”了，第二次遍历时无法产生任何元素。这是因为exampleCustomRange函数每次调用返回的是一个生成器对象，这个对象一旦开始生成元素并耗尽，其内部状态就无法重置。它是一个“一次性”的迭代器。
内置 range 的工作原理
内置的range函数之所以能够重复使用，是因为它实际上是一个类，一个可迭代对象。当你创建一个range对象时，例如r = range(3)，r是一个range类的实例。这个实例本身并不是迭代器，它只是一个知道如何创建迭代器的对象。
每当Python需要对r进行迭代时（例如在for循环或列表推导式中），它会调用r的__iter__方法。range类的__iter__方法会返回一个新的迭代器对象。这意味着每次请求迭代时，都会得到一个全新的、从头开始的迭代器，因此range对象可以被无限次地重复遍历。
实现可重用的自定义 range 类
要实现一个与内置range行为相似、可重用的自定义序列，我们也需要定义一个类，并在这个类中实现__iter__方法。
核心思路是：
- 类的__init__方法用于初始化并存储序列的参数（例如起始值、结束值、步长等）。
- 类的__iter__方法不直接返回序列元素，而是返回一个新的迭代器对象。这个迭代器对象可以是另一个生成器（通过yield实现），也可以是实现了__next__方法的自定义迭代器类实例。
以下是实现一个可重用自定义range类的示例：
class ExampleCustomRange:
"""
一个可重用的自定义range类，行为类似于内置range。
"""
def __init__(self, stop_exclusive):
"""
初始化自定义range对象。
:param stop_exclusive: 序列的独占结束值。
"""
self.stop_exclusive = stop_exclusive
def __iter__(self):
"""
返回一个新的迭代器。每次调用此方法，都会创建一个新的生成器。
"""
print(f"--- __iter__ 被调用，生成新的迭代器 ---")
for i in range(self.stop_exclusive):
yield i
# 验证自定义类的可重用性
print("\n--- 验证 ExampleCustomRange 类的行为 ---")
custom_range_instance = ExampleCustomRange(3)
print("第一次遍历:")
print([x for x in custom_range_instance]) # 第一次遍历
print("第二次遍历:")
print([x for x in custom_range_instance]) # 第二次遍历，仍然有效
print("第三次遍历 (使用for循环):")
for item in custom_range_instance:
print(item, end=" ")
print()运行上述代码，你会发现ExampleCustomRange的实例现在可以像内置range一样被多次遍历。每次for循环或列表推导式尝试迭代custom_range_instance时，都会调用其__iter__方法，而__iter__方法则会返回一个新的生成器对象，从而保证了每次遍历都是从头开始的全新过程。
注意事项
- 可迭代对象 vs. 迭代器：理解这两者的区别至关重要。一个“可迭代对象”是能够返回迭代器的对象（如列表、元组、字符串、以及我们自定义的ExampleCustomRange类实例）。一个“迭代器”是真正执行迭代过程的对象（如list_iterator、str_iterator，以及生成器函数返回的对象）。
-
何时使用生成器函数，何时使用可迭代类：
- 如果你的序列只需要被遍历一次，或者每次遍历时生成逻辑可能不同，那么一个简单的生成器函数通常是更简洁高效的选择。
- 如果你的序列需要被多次遍历，并且每次遍历都希望从头开始，那么你应该创建一个实现__iter__方法的可迭代类，就像我们在这里做的。
-
更完整的自定义序列：对于更复杂的自定义序列，除了__iter__，你可能还需要实现其他特殊方法，例如：
- __len__：返回序列的长度。
- __getitem__：允许通过索引访问元素（使对象成为“序列”）。
- __contains__：支持in运算符。
总结
要创建行为类似于Python内置range的可重用自定义迭代器，关键在于设计一个类，并在其中实现__iter__方法。此方法应负责在每次被调用时返回一个新的迭代器（例如通过yield关键字创建的生成器）。这种模式确保了自定义序列对象能够被多次、独立地遍历，每次都从初始状态开始生成元素，从而避免了简单生成器函数一次性使用的局限性。通过理解可迭代对象和迭代器之间的区别，开发者可以更灵活、高效地设计和实现各种自定义数据结构。
