一个在交流群里讨论过两轮的问题，答案竟然跟一个 PEP 有关

最新推荐文章于 2025-07-25 16:30:08 发布

原创最新推荐文章于 2025-07-25 16:30:08 发布 · 174 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#python #编程语言

探讨Python3中如何通过__qualname__属性解决获取类方法所属类的问题，及该属性的引入背景与作用。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Python 中有没有办法通过类方法找到其所属的类？

这个问题看起来不容易理解，我可以给出一个例子：

class Test:
@xxx
def foo(self):
pass
现在有一个类和一个类方法，其中类方法上有一个装饰器。

我们的问题就是要在装饰器代码中动态地获得 Test 这个类（类名+类对象）。

去年 11 月份的时候，我在微信读者群里提出了这个问题，当时引起了小范围的讨论。

没想到在今年上个月的时候，群里又有人提了同样的问题（我在讨论结束后才看到），而且最终都找到了 stackoverflow 上一个同样的问题：
在这里插入图片描述

stackoverflow 上的问题提得很明确：Get defining class of unbound method object in Python 3 。但是 unbound method 的叫法已经不常见了，详细的讨论也就不展开了，感兴趣的同学可以去查阅。

这个问题的关键是要使用在 Python 3.3 中引入的__qualname__ 属性，通过它可以获取上层类的名称。

铺垫了这么多，开始进入本文的正题了：qualname 属性是什么东西？为什么 Python 3 要特别引入它呢？

下文是 PEP-3155 的翻译摘录，清楚地说明了这个属性的来龙去脉。

完整内容可在 Github 仓库查看：https://github.com/chinesehuazhou/peps-cn/blob/master/StandardsTrack/3155–%E7%B1%BB%E5%92%8C%E6%96%B9%E6%B3%95%E7%9A%84%E7%89%B9%E5%AE%9A%E5%90%8D%E7%A7%B0.md

原理
一直以来，对于嵌套类的自省，Python 的支持很不够。给定一个类对象，根本不可能知道它是在某个类中定义的，还是在顶层模块中定义的；而且，如果是前者，也不可能知道它具体是在哪个类中定义的。虽然嵌套类通常被认为是不太好的用法，但这不应该成为不支持内层自省的理由。

Python 3 因为丢弃了以前的未绑定方法（unbound method），而受到了侮辱性的伤害。

在 Python 2 中，给出以下定义：

class C:
def f():
pass
你可以从C.f 对象中获得其所属的类：

C.f.im_class
<class ‘main.C’>
这种用法在 Python 3 中已经没有了：

C.f.im_class
Traceback (most recent call last):
File “”, line 1, in
AttributeError: ‘function’ object has no attribute ‘im_class’

dir(C.f)
[‘annotations’, ‘call’, ‘class’, ‘closure’, ‘code’,
‘defaults’, ‘delattr’, ‘dict’, ‘dir’, ‘doc’,
‘eq’, ‘format’, ‘ge’, ‘get’, ‘getattribute’,
‘globals’, ‘gt’, ‘hash’, ‘init’, ‘kwdefaults’,
‘le’, ‘lt’, ‘module’, ‘name’, ‘ne’, ‘new’,
‘reduce’, ‘reduce_ex’, ‘repr’, ‘setattr’, ‘sizeof’,
‘str’, ‘subclasshook’]
这就限制了用户可以使用的自省能力。当将程序移植到 Python 3 时，它可能会产生一些实际的问题，例如在 Twisted 的核心代码中，就多次使用到了这种自省方法。此外，这还限制了对 pickle 序列化的支持。

提议
本 PEP 提议在函数和类中添加 qualname 属性。

对于顶层的函数和类，qualname 属性等于__name__ 属性。对于嵌套的类、方法和嵌套函数，qualname 属性包含一个点式路径（dotted path），通向顶层模块下的对象。函数的局部命名空间在点式路径中由名为的组件表示。

函数和类的 repr() 和 str() 被修改为使用__qualname__ 而不再是__name__。

嵌套类的示例

class C:
… def f(): pass
… class D:
… def g(): pass
…

C.qualname
‘C’

C.f.qualname
‘C.f’

C.D.qualname
‘C.D’

C.D.g.qualname
‘C.D.g’
嵌套函数的示例

def f():
… def g(): pass
… return g
…

f.qualname
‘f’

f().qualname
‘f..g’
不足之处
对于嵌套函数（以及在函数内部定义的类），由于无法从外部获得函数的命名空间，因此点式路径无法以动态编程的方式遍历。相比于空的__name__，它对于人类读者还是有些帮助的。