萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Python 記錄詳細呼叫堆疊日誌:sys._getframe() 實戰

除錯複雜呼叫鏈時,單行日誌往往不夠,需要完整的呼叫堆疊(檔案、函式、行號)。Python 透過 sys._getframe() 即可輕鬆實現,無需第三方庫。

核心實作

import sys
import os

def detailtrace(info):
    retStr = ""
    f = sys._getframe().f_back  # 跳過 detailtrace 本身
    while hasattr(f, "f_code"):
        co = f.f_code
        retStr = f"{os.path.basename(co.co_filename)}({co.co_name}:{f.f_lineno})->" + retStr
        f = f.f_back
    print(retStr + info)

def foo():
    detailtrace("hello world")

def bar():
    foo()

def main():
    bar()

if __name__ == "__main__":
    main()

輸出範例

aaa1.py(:27)->aaa1.py(main:24)->aaa1.py(bar:21)->aaa1.py(foo:18)->hello world

關鍵點解析

  • sys._getframe() 回傳當前幀物件,.f_back 追溯呼叫者。
  • f.f_code 包含 co_filename(檔案)、co_name(函式名)。
  • f.f_lineno 為當前執行行號。
  • 迴圈條件 hasattr(f, "f_code") 防止走到頂層無幀物件報錯。

進階封裝建議

import logging

def log_with_stack(logger, level, msg):
    frames = []
    f = sys._getframe().f_back
    while f:
        frames.append(f"{os.path.basename(f.f_code.co_filename)}:{f.f_code.co_name}:{f.f_lineno}")
        f = f.f_back
    logger.log(level, " -> ".join(reversed(frames)) + " | " + msg)

# 使用
logging.basicConfig(level=logging.DEBUG)
log_with_stack(logging.getLogger(), logging.INFO, "關鍵業務節點")

效能提醒

堆疊採樣有微小開銷,高頻熱路徑(如遊戲迴圈、高頻交易)請避免每幀呼叫;一般業務日誌、異常捕獲、追蹤器完全無壓力。

掌握此技巧,即可在無框架支援的腳本中也擁有企業級的呼叫鏈可觀測能力。

copyright © 萬盛學電腦網 all rights reserved