You need to enable JavaScript to run this app. Python如何获取顶层文件中声明的所有类?
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.31 22:36:04