Python如何获取顶层文件中声明的所有类?
适配__main__场景的顶层类检索方案
现有公开方案在__main__场景下失效的核心原因有两个:一是多数实现默认向inspect接口传入模块名字符串而非模块实体,二是没有从全局模块注册表获取当前运行脚本的真实模块对象;另外函数作用域内直接调用无参dir()的返回结果只包含当前局部作用域内容,无法拿到顶层定义的类。
核心实现逻辑
- 通过
sys.modules[__name__]直接获取当前运行的顶层模块实体,无论是被导入的普通模块还是直接执行的__main__脚本,都可以稳定拿到对象引用,无需特殊分支适配。 - 使用
inspect.getmembers遍历模块对象的全部成员,通过inspect.isclass初步筛选出类类型的对象。 - 对比类对象的
__module__属性和当前模块的名称,排除从其他模块导入的类,只保留当前文件顶层直接声明的类。
完整可运行代码
import inspect import sys class FirstClass: pass class SecondClass: pass def get_top_level_classes(): # 获取当前顶层模块实体 current_module = sys.modules[__name__] matched_classes = [] for _, class_obj in inspect.getmembers(current_module, inspect.isclass): # 仅保留当前模块内定义的类 if class_obj.__module__ == current_module.__name__: matched_classes.append(class_obj.__name__) return matched_classes if __name__ == '__main__': # 哪怕函数定义在独立作用域内,也能正确检索顶层类 print(get_top_level_classes())
运行后输出结果为['FirstClass', 'SecondClass'],完全匹配预期。
注意事项
- 不要直接向
inspect.getmembers传入__name__字符串:该接口要求第一个参数传入可遍历的对象实体,传字符串会导致成员遍历逻辑失效,返回无关结果。 - 不要在函数内调用无参
dir():无参dir()默认返回当前局部作用域的成员列表,无法访问文件顶层的全局类定义。 - 必须增加模块归属判断:如果仅用
inspect.isclass做类过滤,会把导入的第三方类、内置类误判为当前文件声明的类,引入不必要的噪音。
内容的提问来源于stack exchange,提问作者Nacromances
相关产品推荐
相关产品推荐

