当前位置:首页 > 文章列表 > 文章 > python教程 > Python inspect.getmembers_static 怎样列出成员而不触发动态属性查找

Python inspect.getmembers_static 怎样列出成员而不触发动态属性查找

来源:17golang原创 2026-11-18 10:00:19 0浏览 收藏

如果你要盘点一个对象有哪些成员,又不希望读取属性时触发副作用,优先考虑 inspect.getmembers_static()。它返回按名称排序的 (name, value) 列表,并绕过 descriptor 协议、__getattr__ 和 __getattribute__ 的动态查找。

官方文档:https://docs.python.org/3/library/inspect.html

它适合做调试器、文档工具或对象清单的第一遍扫描,但不是“更完整的 getmembers”。动态创建的属性可能看不到,某些属性还会以 descriptor 对象本身返回。

先区分动态访问和静态枚举

inspect.getmembers() 的目标是拿到对象当前可访问的成员值。为了得到这个值,它可能经过 descriptor、__getattribute__ 或 __getattr__。对象的属性访问很重、会抛异常或依赖外部状态时,这条路径并不适合做无副作用盘点。

getmembers_static() 则直接沿着对象和类型的静态成员关系查找,不主动触发这些动态入口。函数从 Python 3.11 开始提供,两个函数的返回形状都为按名字排序的二元组列表。

Python getmembers 与 getmembers_static 动态访问和静态枚举边界说明图
图1:静态结构说明图,对比 getmembers 的动态访问路径与 getmembers_static 的无触发枚举路径;不是截图或运行证据。

最小写法:列出成员名和值

调用时只需要传入对象。下面的示例用一个 property 和动态属性入口制造边界:示例的重点不是执行结果,而是说明静态枚举不会为了取值而调用这些入口。

import inspect


class Service:
    """演示静态成员枚举与动态属性访问的差异。"""

    @property
    def status(self):
        # 真实项目中这里可能访问网络或读取外部状态。
        raise RuntimeError("status 需要运行时上下文")

    def __getattr__(self, name):
        # 动态属性只在普通属性查找失败后才产生。
        return f"dynamic:{name}"


service = Service()

# 静态枚举返回 (名称, 静态对象);property 可能以 descriptor 形式出现。
members = inspect.getmembers_static(service)
for name, value in members:
    print(name, type(value).__name__)

注意,列表中的 value 不一定是你平时写 service.status 得到的值。对 property、方法描述器等成员,静态结果可能保留 descriptor;这正是它避免执行属性逻辑所付出的代价。

用 predicate 缩小扫描范围

第二个参数可以传谓词。谓词接收静态结果中的 value,返回真值的成员才会保留。这样可以先建立安全清单,再把少量确定的成员交给后续逻辑处理。

import inspect


class Config:
    retries = 3

    @property
    def endpoint(self):
        # 这个属性仅作为 descriptor 展示,不在盘点阶段读取。
        return "https://service.invalid"


config = Config()

# 只筛选静态结果里确实是整数的成员,避免先读取属性。
integer_members = inspect.getmembers_static(
    config,
    lambda value: isinstance(value, int),
)
print(integer_members)

谓词也要保持轻量。它判断的是静态拿到的对象,不会把 descriptor 自动变成实例值;如果业务需要 property 的最终返回值,应明确承担一次动态访问的成本。

根据任务选择哪个工具

如果目标是调用方真正能读到的值,例如展示一个已经初始化的配置对象,getmembers() 更贴近运行时视图;但要对外部状态、懒加载或自定义属性访问保持警惕。

如果目标是做对象结构盘点、生成文档、分析未知对象,或者你不能接受访问属性产生副作用,选择 getmembers_static()。它的结果更像“当前可静态发现的成员表”,不要把它误当成完整的动态 API。

Python getmembers 和 getmembers_static 工具选择决策说明图
图2:工具选择说明图,展示真实属性值、descriptor 和动态成员之间的取舍;不是截图或运行证据。
你的目标优先选择需要记住
拿到运行时可访问值getmembers()可能触发动态查找或 descriptor
无副作用盘点成员getmembers_static()可能返回 descriptor,可能漏掉动态成员
只看特定类型任一函数配 predicate先确认谓词看到的是动态值还是静态对象

常见问题

getmembers_static 会发现 __getattr__ 动态生成的属性吗?

通常不会。它避免触发动态属性查找,因此只能列出静态关系中可发现的成员。

为什么结果里出现 property,而不是 property 返回值?

这是预期行为。静态枚举不会执行 descriptor,返回 descriptor 本身能帮助工具识别结构,也避免在盘点阶段触发代码。

它能完全替代 getmembers 吗?

不能。需要运行时值时仍应使用 getmembers(),并为属性访问可能产生的异常、I/O 或状态变化设计处理边界。

一句话总结:要看“对象当前能访问到什么”,用 getmembers();要看“对象静态声明了什么且不要触发属性逻辑”,用 getmembers_static(),同时接受 descriptor 和动态成员不可见这两个边界。

版本声明
本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
Go net/textproto.Reader.DotReader 怎样读取点终止且需要反转义的正文Go net/textproto.Reader.DotReader 怎样读取点终止且需要反转义的正文
上一篇
Go net/textproto.Reader.DotReader 怎样读取点终止且需要反转义的正文
JavaScript Node.lookupPrefix 怎样按命名空间URI查询关联的前缀
下一篇
JavaScript Node.lookupPrefix 怎样按命名空间URI查询关联的前缀
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1091次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1088次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1252次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1196次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1041次使用
查看更多
相关文章
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码