Python inspect.getmembers_static 怎样列出成员而不触发动态属性查找
如果你要盘点一个对象有哪些成员,又不希望读取属性时触发副作用,优先考虑 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 开始提供,两个函数的返回形状都为按名字排序的二元组列表。

最小写法:列出成员名和值
调用时只需要传入对象。下面的示例用一个 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。

| 你的目标 | 优先选择 | 需要记住 |
|---|---|---|
| 拿到运行时可访问值 | getmembers() | 可能触发动态查找或 descriptor |
| 无副作用盘点成员 | getmembers_static() | 可能返回 descriptor,可能漏掉动态成员 |
| 只看特定类型 | 任一函数配 predicate | 先确认谓词看到的是动态值还是静态对象 |
常见问题
getmembers_static 会发现 __getattr__ 动态生成的属性吗?
通常不会。它避免触发动态属性查找,因此只能列出静态关系中可发现的成员。
为什么结果里出现 property,而不是 property 返回值?
这是预期行为。静态枚举不会执行 descriptor,返回 descriptor 本身能帮助工具识别结构,也避免在盘点阶段触发代码。
它能完全替代 getmembers 吗?
不能。需要运行时值时仍应使用 getmembers(),并为属性访问可能产生的异常、I/O 或状态变化设计处理边界。
一句话总结:要看“对象当前能访问到什么”,用 getmembers();要看“对象静态声明了什么且不要触发属性逻辑”,用 getmembers_static(),同时接受 descriptor 和动态成员不可见这两个边界。
Go net/textproto.Reader.DotReader 怎样读取点终止且需要反转义的正文
- 上一篇
- Go net/textproto.Reader.DotReader 怎样读取点终止且需要反转义的正文
- 下一篇
- JavaScript Node.lookupPrefix 怎样按命名空间URI查询关联的前缀
-
- 文章 · python教程 | 4小时前 | python · SQLite · Python sqlite3 Connection.interrupt 长查询 OperationalError
- Python sqlite3.Connection.interrupt 怎样从线程中止长查询
- 287浏览 收藏
-
- 文章 · python教程 | 4小时前 | 错误处理 · 字符集 · Python教程 · Python MIME email.utils collapse_rfc2231_value RFC 2231
- Python collapse_rfc2231_value 怎样还原带字符集的参数
- 330浏览 收藏
-
- 文章 · python教程 | 5小时前 |
- Python dataclasses.fields 怎样读取数据类的字段元数据
- 348浏览 收藏
-
- 文章 · python教程 | 5小时前 | python · Python 批量处理 迭代器 itertools.batched
- Python itertools.batched 怎样把可迭代对象分成固定大小的批次
- 275浏览 收藏
-
- 文章 · python教程 | 5小时前 | 日志 · 标准库 · HTTP · python · Python HTTPS post logging.handlers.HTTPHandler HTTPHandler 远程日志
- Python logging.handlers.HTTPHandler 怎样把日志发送到 HTTP 服务
- 262浏览 收藏
-
- 文章 · python教程 | 5小时前 | 标准库 · 测试 · python · Python 标准输出 io.StringIO contextlib redirect_stdout
- Python contextlib.redirect_stdout 怎样把临时输出重定向到内存
- 205浏览 收藏
-
- 文章 · python教程 | 5小时前 | python · Python unicode unicodedata decomposition
- Python unicodedata.decomposition 怎样读取字符分解映射与兼容标签
- 474浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1091次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1088次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1252次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1196次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1041次使用
-
- Goreflect反射原理示例详解
- 2022-12-22 174浏览
-
- 详解如何让Go语言中的反射加快
- 2023-02-24 246浏览
-
- Golang 中反射的应用实例详解
- 2022-12-31 353浏览
-
- Go语言的反射机制详解
- 2022-12-28 126浏览
-
- go-spew调试利器详解
- 2023-01-07 282浏览

