issubclass用于判断类是否为另一类的子类,只接受类对象作第一参数,第二参数可为类、元组或类型;不支持实例、字符串;需注意abc注册、多重继承mro、与isinstance区别及泛型兼容性。

issubclass 用法和基本判断逻辑
issubclass 是 Python 内置函数,用于判断一个类是否是另一个类的子类(直接或间接),它不关心实例,只看类定义时的 class A(B): 关系。
调用形式固定为 issubclass(cls, class_or_tuple),第一个参数必须是类对象(不能是字符串或实例),第二个参数可以是单个类、元组(支持多选)或类型对象(如 int、Exception)。
常见错误:传入实例会直接报 TypeError: issubclass() arg 1 must be a class;传入字符串(如 "str")也会失败——Python 不做隐式字符串转类名解析。
验证多重继承和抽象基类时的注意事项
Python 支持多重继承,issubclass 会完整遍历整个 MRO(Method Resolution Order)链,包括所有父类及其祖先。但要注意:抽象基类(ABC)需显式注册或继承才能被识别。
例如 collections.abc.Iterable 是 ABC,list 并未直接继承它,而是通过 register() 或内置实现被纳入检查范围:
import collections.abc print(issubclass(list, collections.abc.Iterable)) # True print(issubclass(dict, collections.abc.Mapping)) # True
若自定义类想被 issubclass 正确识别为某 ABC 的子类,必须:
- 继承该 ABC,或
- 显式调用 MyABC.register(MyClass),且注册需在调用 issubclass 前完成
和 isinstance 的关键区别与误用场景
issubclass 检查的是「类与类」的关系,isinstance 检查的是「实例与类」的关系。两者不可互换。
典型误用:想判断某个变量是否为 dict 子类的实例,却写了 issubclass(obj, dict) —— 这会因 obj 不是类而报错。
正确做法分两步:
- 先确认 obj 是实例:用 isinstance(obj, dict)
- 若需确认其所属类是否继承自某基类:用 issubclass(obj.__class__, Base)
性能上,issubclass 开销极小(纯静态检查),但频繁在循环里判断同一对类关系没必要——结果不会变,可缓存。
检查内置类型和泛型时的兼容性陷阱
Python 3.9+ 引入了 PEP 585,允许用 list[int] 这类原生泛型作为 issubclass 的第二个参数,但仅限于某些内置泛型(如 list, dict, tuple)。
以下写法在 3.9+ 有效:
issubclass(list, list) # True issubclass(list, list[str]) # True —— 注意:这里不是类型检查,而是把 list[str] 当作 list 的别名处理
但以下会出错:
- issubclass(my_class, list[int]) 中 my_class 是自定义类 → 不报错但语义无效(泛型参数被忽略)
- issubclass(int, int | str) → 报 TypeError,联合类型(|)不被 issubclass 支持
真正需要类型推导的场景,应改用 typing.get_origin + get_args 配合运行时检查,而非依赖 issubclass。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











