可多次迭代的对象应使用什么类型提示？

你遇到的这个问题确实很常见——想要一个能反复迭代的类型，但又不想附带不必要的约束（比如顺序、成员检查）。咱们一步步拆解来看：

首先明确核心需求：支持多次调用iter()返回独立迭代器的对象，也就是“可重启迭代”的类型，同时不需要Sequence的索引访问能力，也不需要Collection的成员判断能力。

接下来分析几个常见候选类型的优劣：

• Iterable：完全不合适，因为生成器、一次性迭代器这类实现了Iterable的对象只能迭代一次，完全不符合你的需求，直接排除。
• Sequence：虽然能多次迭代，但它强制要求实现__getitem__和__len__，意味着必须支持索引访问，这是你不需要的额外约束，也不是最佳选择。
• Collection：它继承了Iterable、Sized和Container，也就要求实现__contains__（成员检查），而你明确说不需要这个能力，所以这个类型有点“过重”了。

那最佳选择是什么呢？这里有几个实用方向：

方向一：自定义专属协议（最精准） #

如果你想让静态类型检查器帮你严格约束这个行为，可以用typing.Protocol定义一个只要求支持多次迭代的协议：

from typing import Protocol, Iterator

class MultiIterable(Protocol):
    def __iter__(self) -> Iterator:
        """每次调用都返回一个新的、可从头迭代的独立迭代器"""
        ...

def loop_twice(param: MultiIterable):
    for thing in param:
        print(thing)

    for thing in param:
        print(f"{thing} again")

这个协议只要求对象实现__iter__，并且隐含约定每次调用都要返回全新的迭代器。像列表、集合、元组这些原生容器都会自动符合这个协议，而生成器这类一次性迭代器则会被静态检查器拦截（动态场景下的例外情况极少）。

方向二：用Iterable加文档说明（最简便） #

如果团队内部沟通顺畅，你可以继续用Iterable，但在函数的文档字符串里明确标注约束：

from typing import Iterable

def loop_twice(param: Iterable):
    """
    对传入的参数进行两次迭代输出
    
    Args:
        param: 必须是可多次迭代的对象（请勿传入生成器等一次性迭代器）
    """
    for thing in param:
        print(thing)

    for thing in param:
        print(f"{thing} again")

这个方案的好处是不需要额外定义类型，但缺点是依赖文档约束，静态检查器没法帮你拦截不符合要求的参数。

方向三：退而求其次用Collection（折中方案） #

如果不想自定义协议，且__contains__的约束对你来说不是大问题，那用Collection也完全可行——毕竟大部分能多次迭代的容器类都实现了__contains__，而且静态检查器能帮你排除生成器这类一次性迭代器。

总结一下：

• 追求最精准的类型约束：自定义MultiIterable协议
• 追求简单且团队沟通到位：用Iterable加文档说明
• 不想自定义类型且能接受小额外约束：用Collection

备注：内容来源于stack exchange，提问作者Pro Q