工程规范01
命名隔离与防重复输出
使用 getLogger(__name__) 按模块树状继承,避免直接操作 root;若出现重复打印,检查是否多次添加 Handler 或未关闭 propagate。
异常溯源02
捕获完整堆栈 Traceback
在 except 块中优先调用 logger.exception() 或传参 exc_info=True,精准保留报错行号与调用链,杜绝只打异常字符串。
磁盘安全03
日志轮转防爆满磁盘
生产环境严禁裸用 FileHandler,应使用 RotatingFileHandler(按大小切分)或 TimedRotatingFileHandler(按天归档)。
调试思维04
二分定位与上下文锚点
Formatter 必含时间、模块、行号与 request_id;复杂 Bug 采用“输入校验 → 关键分支 → 外部调用”二分打点快速收敛。
调试铁律:开发期用 DEBUG 追踪状态流转,线上以 INFO/WARNING 守卫性能,ERROR 必带堆栈。