萬盛學電腦網

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

Python 程式除錯四大技法:print、assert、logging、pdb 實戰對比與最佳實踐

Bug 修復是開發常態。本文系統對比四種除錯手法:print 大法、assert 斷言、logging 記錄、pdb 互動式除錯器,分析優缺點與適用場景,並提供 pdb.set_trace() 斷點除錯實戰指南。

方法一:print 大法(最原始)

def foo(s):
    n = int(s)
    print('>>> n = %d' % n)
    return 10 / n

foo('0')
# >>> n = 0
# ZeroDivisionError

缺點:上線前須清理、輸出混雜、無條件控制、效能影響。

方法二:assert 斷言(開發期自檢)

def foo(s):
    n = int(s)
    assert n != 0, 'n is zero!'
    return 10 / n
  • 失敗拋出 AssertionError,訊息可自訂
  • 生產環境關閉:python -O (優化模式) 忽略所有 assert
  • 適用:前置條件檢查、不變量驗證、防禦性程式設計

方法三:logging 模組(生產級標準)

import logging
logging.basicConfig(level=logging.INFO)

s = '0'
n = int(s)
logging.info('n = %d', n)
print(10 / n)

優勢:

  • 分級控制:DEBUG INFO WARNING ERROR CRITICAL
  • 多輸出目的地:Console、File、Syslog、HTTP、Email
  • 格式化統一:時間、模組、行號、執行緒、進程 ID
  • 效能:isEnabledFor() 檢查避免字串格式化開銷

進階配置範例

import logging.config

LOGGING = {
    'version': 1,
    'formatters': {
        'standard': {'format': '%(asctime)s [%(levelname)s] %(name)s:%(lineno)d: %(message)s'}
    },
    'handlers': {
        'console': {'class': 'logging.StreamHandler', 'formatter': 'standard', 'level': 'INFO'},
        'file': {'class': 'logging.handlers.RotatingFileHandler', 'filename': 'app.log', 'maxBytes': 1024*1024*10, 'backupCount': 5, 'formatter': 'standard', 'level': 'DEBUG'},
    },
    'root': {'handlers': ['console', 'file'], 'level': 'DEBUG'},
}
logging.config.dictConfig(LOGGING)

方法四:pdb 互動式除錯器(深度診斷)

啟動方式

$ python -m pdb script.py      # 整支腳本單步
# 或程式碼內植入斷點
import pdb; pdb.set_trace()

核心指令速查

指令縮寫功能
listl顯示當前行上下文
nextn單步執行(不進入函式)
steps單步進入函式
continuec繼續執行至下一斷點
print 變數p 變數查看變數值
pp 變數pp美化輸出複雜結構
break 行號/函式b設定斷點
quitq退出除錯器

實戰流程示範

$ python -m pdb err.py
> /path/err.py(2)() -> s = '0'
(Pdb) l
  1 # err.py
  2 -> s = '0'
  3     n = int(s)
  4     print 10 / n
(Pdb) n
> /path/err.py(3)() -> n = int(s)
(Pdb) n
> /path/err.py(4)() -> print 10 / n
(Pdb) p s
'0'
(Pdb) p n
0
(Pdb) q

四大技法選型決策表

場景推薦備註
快速驗證假設print / pdb.set_trace()臨時、一次性
函式前置條件檢查assert文檔化契約
生產環境問題排查logging持久化、分級、可檢索
複雜邏輯單步追蹤pdb / IDE 除錯器PyCharm/VSCode 圖形化更強
CI/CD 自動化測試pytest + logging capture結合測試框架

現代工具鏈建議

  • IDE 除錯器(VSCode Debugpy、PyCharm)取代命令列 pdb
  • pytest --pdb 測試失敗自動進入除錯
  • ipdb / pdbpp:語法高亮、Tab 補全、更好體驗
  • 分散式追蹤:OpenTelemetry、Sentry、Datadog
copyright © 萬盛學電腦網 all rights reserved