Bug 修復是開發常態。本文系統對比四種除錯手法:print 大法、assert 斷言、logging 記錄、pdb 互動式除錯器,分析優缺點與適用場景,並提供 pdb.set_trace() 斷點除錯實戰指南。
def foo(s):
n = int(s)
print('>>> n = %d' % n)
return 10 / n
foo('0')
# >>> n = 0
# ZeroDivisionError
缺點:上線前須清理、輸出混雜、無條件控制、效能影響。
def foo(s):
n = int(s)
assert n != 0, 'n is zero!'
return 10 / n
AssertionError,訊息可自訂python -O (優化模式) 忽略所有 assertimport logging
logging.basicConfig(level=logging.INFO)
s = '0'
n = int(s)
logging.info('n = %d', n)
print(10 / n)
優勢:
DEBUG INFO WARNING ERROR CRITICALisEnabledFor() 檢查避免字串格式化開銷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)
$ python -m pdb script.py # 整支腳本單步
# 或程式碼內植入斷點
import pdb; pdb.set_trace()
| 指令 | 縮寫 | 功能 |
|---|---|---|
| list | l | 顯示當前行上下文 |
| next | n | 單步執行(不進入函式) |
| step | s | 單步進入函式 |
| continue | c | 繼續執行至下一斷點 |
| print 變數 | p 變數 | 查看變數值 |
| pp 變數 | pp | 美化輸出複雜結構 |
| break 行號/函式 | b | 設定斷點 |
| quit | q | 退出除錯器 |
$ 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 | 結合測試框架 |
pytest --pdb 測試失敗自動進入除錯ipdb / pdbpp:語法高亮、Tab 補全、更好體驗