python - python 中的 __qualname__ 是什么？

Question

• Python 中的 __qualname__ 是什么以及它有什么用处？

• 为什么我需要使用它而不是 __name__？

我读了docs ，但它们并没有帮助我清楚地了解它的用处。

我已阅读Get fully qualified name of a Python class (Python 3.3+) .
该问题询问“如何获得限定名称”，假设人们知道“限定名称”的含义。显然，这个问题的答案是使用 __qualname__ 属性。

我的问题是问什么__qualname__是什么，以及为什么我应该使用它而不是__name__。

Answer 1

__qualname__ 提供比 __name__ 更完整的信息，因此在调试等方面更有帮助。

示例:

>>> def f(): pass
... class A:
...    def f(self): pass
...    class A:
...        def f(self): pass
...
>>> # __name__ is not showing the path, so these functions look equal
>>> f.__name__
'f'
>>> A.f.__name__
'f'
>>> A.A.f.__name__
'f'
>>> # And these classes looks equal
>>> A.__name__
'A'
>>> A.A.__name__
'A'
>>>
>>> # __qualname__ shows the path, so these functions are distinguishable
>>> f.__qualname__
'f'
>>> A.f.__qualname__
'A.f'
>>> A.A.f.__qualname__
'A.A.f'
>>> # And these classes are distinguishable
>>> A.__qualname__
'A'
>>> A.A.__qualname__
'A.A'

__qualname__ 还添加了与 Python 2 的 .im_class 的一些向后兼容性。

More details in the rationale for PEP 3155