为何Python无法推断自定义类遵循Sequence协议？

你遇到的问题核心在于：Python的collections.abc.Sequence是抽象基类（ABC），它的isinstance判定逻辑不是单纯检查你是否实现了所有协议方法，而是有特定规则：

• ABC默认只认直接/间接继承它的类，或者通过Sequence.register(MySequence)手动注册的类。
• 虽然Sequence的__subclasshook__有一套检查逻辑（比如验证是否实现__getitem__和__len__，且__getitem__符合序列索引行为），但这套逻辑不会自动将未继承、未注册的类判定为Sequence的子类——它的作用是给已继承/注册的类做合规性检查，或是对内置类型做自动识别。

你的代码里，MySequence既没有继承Sequence，也没有注册到它，哪怕实现了所有方法，isinstance也会返回False。

解决办法 #

有两种方式让isinstance返回True：

1. 直接继承Sequence #

继承后，ABC会自动提供很多方法的默认实现（比如__contains__、count、index你甚至不用自己写）：

from collections.abc import Sequence

class MySequence(Sequence):
    def __getitem__(self, ix):
        pass
    
    def __len__(self):
        pass

seq = MySequence()
print(isinstance(seq, Sequence))  # 输出True

2. 手动注册类到Sequence #

如果不想继承，可以用register方法把你的类注册为Sequence的虚拟子类：

from collections.abc import Sequence

class MySequence:
    def __getitem__(self, ix):
        pass
    
    def __iter__(self):
        pass
    
    def __len__(self):
        pass
    
    def __contains__(self, val):
        pass
    
    def __reversed__(self):
        pass
    
    def count(self, val):
        pass
    
    def index(self, val):
        pass

Sequence.register(MySequence)  # 注册虚拟子类

seq = MySequence()
print(isinstance(seq, Sequence))  # 输出True

补充说明 #

Python的鸭子类型更多是针对语法层面的行为兼容（比如实现__iter__的对象就能用for循环遍历），而isinstance针对ABC的检查是另一套机制——ABC是用来定义接口规范的，不是单纯的鸭子类型判定工具。

内容的提问来源于stack exchange，提问作者Alexander Soare