推荐生产环境用 inspect.stack()[0].function,因其跨解释器兼容、稳定可靠;sys._getframe().f_code.co_name 虽快但属 CPython 内部 API,存在可移植性、安全性及优化模式风险。

直接用 sys._getframe().f_code.co_name 最快,但它是 CPython 内部 API,不保证跨解释器兼容;生产环境更推荐 inspect.stack()[0].function 或封装后的健壮写法。
为什么 sys._getframe() 看起来简单却要谨慎用
它绕过 Python 的标准栈遍历接口,直接读取当前帧对象,所以性能高、代码短。但问题也很实在:
-
sys._getframe()在 PyPy、Jython 等非 CPython 解释器中可能不存在或行为不同 - 某些安全加固环境(如某些容器沙箱、代码审计工具)会禁用该函数
- 被优化的调用(如
@lru_cache包裹后)可能返回缓存层的方法名,而非原始调用者 - 如果开启
-O或-OO优化模式,部分帧信息可能被剥离(虽不影响f_code.co_name,但属潜在风险)
inspect.stack()[0].function 是什么,怎么用才不慢
这是标准库推荐方式,本质是解析当前栈帧并提取函数名。它比 _getframe 多一层解析,但稳定、可移植:
- 必须加索引
[0]—— 否则拿到的是调用inspect.stack()的那个函数名(即你封装的工具函数本身) - 首次调用有明显开销(约 10–20μs),后续调用因内部缓存会快很多,但高频日志场景仍建议缓存结果
- 在异步协程里(
async def)也能正常工作,返回的是协程函数名,不是coroutine object
基础用法:
import inspect
def get_current_function_name():
return inspect.stack()[0].function
真正适合生产环境的封装建议
不要每次调用都走完整栈解析。常见可靠做法是:
立即学习“Python免费学习笔记(深入)”;
- 用
sys._getframe(1)(跳过封装函数自身)+.f_code.co_name,比inspect.stack()快 3–5 倍,且在主流 CPython 版本中长期稳定 - 加 fallback:当
sys._getframe不可用时,退回到inspect.stack() - 避免在热路径(如循环体内、高频回调)反复调用;如需多次使用,应提前获取并复用
- 注意装饰器场景:若函数被
@wraps包裹,两种方式都能正确返回原始函数名;但自定义装饰器未调用functools.wraps时,会返回装饰器内部函数名
容易被忽略的边界情况
方法名获取不是“取个字符串”那么简单:
- 类方法中,
self.__class__.__name__ + "." + function_name才算完整标识,单纯函数名无法区分同名方法 - lambda 表达式返回
"<lambda>"</lambda>,无法还原上下文 - 交互式环境(IPython/Jupyter)中,顶层代码块无函数名,返回
"<module>"</module>或"<cell line: x>"</cell> - 嵌套函数里调用,拿到的是内层函数名——这符合预期,但有时用户误以为该返回外层
这些细节不处理,日志或调试信息就容易失真。别只图一行代码省事。


















