如何优雅检测Python嵌套函数的定义归属以生成友好调用图标识

直接利用Python内置的__qualname__属性是最靠谱的方案，这是Python 3.3+官方引入的特性，专门用于表示嵌套函数、类方法的层级化名称，完全替代字符串解析的hack方式。

核心方案：使用__qualname__ #

函数（包括闭包、类方法）的__qualname__属性会自动保留完整的嵌套结构：

• 类Test的方法a内部定义的闭包b，其__qualname__为Test.a.b
• 普通嵌套函数outer里的inner，__qualname__为outer.inner

改造trace函数示例 #

结合inspect模块的trace回调，直接获取__qualname__生成友好名称：

import inspect
import sys

def trace_calls(frame, event, arg):
    if event != 'call':
        return trace_calls
    
    code_obj = frame.f_code
    func_name = code_obj.co_name
    qualname = None

    # 优先从全局变量获取函数对象的__qualname__（处理全局函数/类方法）
    try:
        func_obj = frame.f_globals[func_name]
        qualname = func_obj.__qualname__
    except KeyError:
        # 从局部变量中匹配闭包对象
        for name, obj in frame.f_locals.items():
            if inspect.isfunction(obj) and obj.__code__ is code_obj:
                qualname = obj.__qualname__
                break
        # 兼容Python 3.10+：code对象自带co_qualname属性
        if not qualname and hasattr(code_obj, 'co_qualname'):
            qualname = code_obj.co_qualname
    
    # 拼接完整名称
    module_name = frame.f_globals['__name__']
    full_name = f"{module_name}.{qualname}" if qualname else f"{module_name}.{func_name}"
    print(full_name)
    return trace_calls

# 测试代码
class Test:
    def a(self):
        def b():
            pass
        b()

# 启动trace并执行测试
sys.settrace(trace_calls)
Test().a()
sys.settrace(None)

运行后会输出：

__main__.Test.a
__main__.Test.a.b

为什么这比解析字符串优雅？ #

• 稳定性：__qualname__是官方标准属性，格式不会随Python版本变更；而函数的字符串表示（如<function Test.a.<locals>.b at ...>）属于调试输出，无格式承诺，版本迭代中可能变化。
• 简洁性：直接读取属性即可，无需编写字符串分割、正则匹配等易出错的逻辑。
• 兼容性：覆盖类方法、普通嵌套函数、闭包等所有场景，无需针对不同情况写分支处理。

内容的提问来源于stack exchange，提问作者Alex L