Python 如何阅读错误堆栈信息

遇到 Python 错误时，解释器通常会输出一段堆栈跟踪（traceback），它能帮你快速定位问题所在。关键不是怕出错，而是学会读懂它。

理解 traceback 的结构

当你看到错误信息时，最上面通常是错误类型和简要描述，往下是函数调用的层级顺序，从最深的调用逐层回退到主程序。例如：

Traceback (most recent call last):
  File "example.py", line 5, in 
    result = divide(10, 0)
  File "example.py", line 2, in divide
    return a / b
ZeroDivisionError: division by zero

这里的流程是：

• 最后一行：实际抛出的错误类型和具体信息 —— ZeroDivisionError: division by zero
• 往上两行：指出错误发生在哪个文件、哪一行、哪个函数中
• 最上面几行：展示调用链路，从主程序一步步进入函数的过程

从下往上看，定位源头

别从头读起。正确做法是从最后一行开始：

• 先看错误类型，比如 NameError、TypeError、IndexError，这些名字往往直接说明了问题性质
• 再看提示信息，如 “name 'x' is not defined” 或 “unsupported operand type(s)”
• 然后查看对应文件名和行号，打开文件跳转到那一行检查代码逻辑

常见错误类型快速对照

熟悉一些典型错误有助于快速反应：

• NameError：使用了未定义的变量
• TypeError：操作对象类型不支持该操作，比如对整数用 len()
• IndexError：列表索引超出范围
• KeyError：字典中找不到指定键
• AttributeError：对象没有某个属性或方法
• ImportError：导入模块失败

调试建议

光看堆栈还不够，可以辅助以下方法：

• 在可疑代码前后加 print() 输出变量值
• 使用 try...except 捕获异常并打印更详细上下文
• 借助 IDE 或调试工具（如 pdb）设置断点逐步执行
• 注意缩进错误（IndentationError）这类语法问题也常出现在 traceback 中

基本上就这些。多练几次就会发现，traceback 不是敌人，而是帮你找 bug 的导航图。