Python 的 __subclasses__() 仅返回当前已加载并执行过定义语句的子类，不会自动扫描文件系统或未导入模块；要实现跨模块子类自动注册，需显式导入对应模块或采用动态导入机制。
python 的 `__subclasses__()` 仅返回当前已加载并执行过定义语句的子类，不会自动扫描文件系统或未导入模块；要实现跨模块子类自动注册，需显式导入对应模块或采用动态导入机制。
在 Python 中，BaseClass.__subclasses__() 返回的是运行时已知的直接子类列表——关键在于“已知”：它依赖于类定义语句是否已被 Python 解释器执行过。当你将 SubClass 定义在独立文件 sub_class.py 中，而 main.py 仅导入 BaseClass 却未导入 sub_class.py，该子类的类对象根本未被创建，自然不会出现在 __subclasses__() 结果中。这并非 bug，而是 Python 类加载机制的固有行为：类只有在模块被导入（且顶层代码被执行）时才被实例化为 type 对象，并完成对父类 __subclasses__ 列表的注册。
因此，以下两种方式均可使 SubClass 正确出现在结果中：
✅ 显式导入子类模块（推荐，清晰可控）
# main.py
from base import BaseClass
import sub_class # 触发 sub_class.py 执行，注册 SubClass
if __name__ == "__main__":
print(BaseClass.__subclasses__()) # [<class>]</class>
✅ 动态导入指定目录下所有子类模块（适用于插件式架构）
# utils.py
import importlib
import pkgutil
import inspect
from base import BaseClass
def discover_subclasses(package_path: str, base_class=BaseClass):
"""递归扫描包路径，动态导入并返回所有非抽象子类"""
subclasses = []
for _, module_name, _ in pkgutil.walk_packages([package_path]):
try:
module = importlib.import_module(f"{package_path.replace('/', '.').replace('\', '.')}.{module_name}")
for name, obj in module.__dict__.items():
if (isinstance(obj, type)
and not inspect.isabstract(obj)
and issubclass(obj, base_class)
and obj is not base_class):
subclasses.append(obj)
except (ImportError, AttributeError):
continue
return subclasses
# 使用示例（假设子类位于 ./commands/ 目录）
# from utils import discover_subclasses
# commands = discover_subclasses("./commands")
⚠️ 注意事项：
- __subclasses__() 不包含间接子类（即孙子类），仅返回直接继承自 BaseClass 的类；如需全部后代，应递归调用 cls.__subclasses__()。
- 动态导入存在安全风险，生产环境应校验模块来源、避免通配符导入。
- 抽象基类需正确定义：@abc.abstractmethod 方法必须被子类实现，否则 inspect.isabstract(subclass) 仍返回 True。
- 若使用 typing.Protocol 或 dataclass 等替代方案，__subclasses__() 不适用——它们不参与 MRO 注册。
总结：Python 的类发现本质是运行时注册机制，而非静态分析。对于 CLI 工具（如 Typer）、插件系统或领域驱动设计中的策略模式，应主动管理子类加载流程——或通过约定式导入（如 from commands import *），或借助 pkgutil + importlib 实现自动化发现，而非依赖 __subclasses__() 的“魔法”行为。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
