Python 教程 / 阅读 traceback 并使用调试器与 logging

排查错误时,先读 traceback 最后的异常类型与消息,再找到自己代码中的文件和行,复现当时的输入。调试器用于观察暂停时的变量和调用栈,logging 则按级别记录程序事件;日志记录与程序是否失败退出是不同机制。

先复现输入,再观察执行状态

从 traceback 底部确认是什么异常,再沿调用路径查看自己的代码。先检查传入库的值与设置,不要因为错误最后出现在库内部,就立即修改库源码。尽量去掉无关文件与步骤,保留能稳定触发问题的最小例子。

在 VS Code 中打开本例目录,选择项目 Python 解释器,并确保 Python 与 Python Debugger 扩展已配置。在可执行行左侧单击设置断点,通过 Run > Start Debugging 启动;若出现配置选择,为这个简单脚本选择 Python File。暂停后查看 Variables 与 Call Stack,而不是只看最终输出。

可以把断点设在下面函数的 if any(...)一行,此时该行还未执行,应能检查 amounts。将列表改为包含 -1 后比较相同位置的值,再继续执行观察异常路径。停止调试,恢复数据,再运行正常路径。配置细节见VS Code 官方 Python 调试说明。

运行带日志的完整计算程序

将完整内容以 UTF-8 保存为 logging_demo.py,在项目环境执行 python logging_demo.py。若核对过的解释器命令是 python3,则使用 python3 logging_demo.py。本例只依赖标准库:

import logging

logging.basicConfig(level=logging.INFO, format="%(levelname)s:%(message)s")
logger = logging.getLogger(__name__)

def calculate(amounts):
    logger.debug("count=%s", len(amounts))
    if any(x < 0 for x in amounts):
        raise ValueError("negative amount")
    return sum(amounts)

try:
    total = calculate([3500, 8000, 2500])
except ValueError:
    logger.exception("calculation failed")
    raise SystemExit(1)
else:
    logger.info("total=%s", total)
print("finished")

标准输出 stdout 的预期内容:

finished

另外,默认日志通道 stderr 会记录 INFO:total=14000。这两部分可能同时显示在终端;它们并不属于同一个输出通道。INFO 级别下,count=3 的 DEBUG 记录不会出现。正常程序应以状态 0 结束。

getLogger(__name__) 创建以当前模块命名的 logger,basicConfig 在这里配置根日志处理。建议在新的程序进程里比较设置;若交互环境已有处理器,basicConfig 可能不会按你期待的方式再次配置。不要在较大的程序中不加判断地强制覆盖其他代码的日志配置。

选择级别并区分日志与退出状态

级别 通常用途
DEBUG 详细诊断与排查信息
INFO 正常进展和结果
WARNING 需要注意、但程序可能仍可继续的情况
ERROR 某项操作已失败

按应用政策一致使用级别。有关配置和记录方法,见Python 官方 logging 教程。格式参数中的百分号占位与 logger.info("total=%s", total) 配合,让记录内容包含实际金额。

把金额改成负数时,calculate 抛出 ValueError,except 中的 logger.exception 记录 ERROR 消息以及当前异常 traceback。随后代码显式 raise SystemExit(1),因此不会执行最后的 finished。只记录 ERROR 本身不会自动把程序状态改为失败,退出语义见Python 官方 sys.exit 说明。

执行命令后立即在 PowerShell 查看 $LASTEXITCODE;在 macOS、Ubuntu 常用 shell 查看 echo $?。后续命令可能改变状态,所以不要隔了多次操作才读取。正常输入应为 0,负数实验应为 1。捕获 stdout 与 stderr 后合并显示的工具,可能让观察到的顺序与预期不同。

故意制造错误并恢复原始行为

  1. 只把列表中的 8000 改成 -1,重新运行。应看到 ERROR:calculation failed、traceback 与 ValueError: negative amount,标准输出没有 finished,退出状态为 1。
  2. 恢复金额,再把 basicConfig 中的 logging.INFO 改成 logging.DEBUG,重新启动程序。应增加 DEBUG:count=3,同时保留 INFO 合计和 finished。
  3. 恢复 INFO 和原始列表,重新运行,应再次得到正常合计、finished 与退出状态 0。若结果不同,先确认运行的是已保存的同一文件和同一解释器。

不要用空的宽泛处理器隐藏失败。先按异常处理的恢复边界决定调用者是否需要知道失败,再记录必要的操作上下文。用户提示与开发诊断面向不同读者;避免把密码、认证头或完整个人数据写入日志。高频循环里反复记录巨大对象也会消耗时间与存储,文件日志还应明确位置、轮换、保留期限和访问权限。