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 'sub_class.SubClass'>]✅ 动态导入指定目录下所有子类模块（适用于插件式架构）
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
立即学习“Python免费学习笔记（深入）”；
# 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__() 的“魔法”行为。
