正文共:11813 字 2 图
预计阅读时间: 30 分钟
原文:https://realpython.com/python-traceback/
译者:陈祥安 原文有所改动。
在写 Python 代码的时候,当代码中出现错误,会在输出的时候打印 Traceback 错误信息,很多初学者看到那一堆错误信息,往往都会处于懵逼状态,脑中总会冒出一句,这都是些啥玩意。如果你是第一次看到它,也许你不知道它在告诉你什么。虽然 Python 的 Traceback 提示信息看着挺复杂,但是里面丰富的信息,可以帮助你诊断和修复代码中引发异常的原因,以及定位到具体哪个文件的哪行代码出现的错误,所以说学会看懂 Traceback 信息是非常重要的,那么,接下来就让我们对其进行详细理解。
什么是 Traceback
Traceback 是 Python 错误信息的报告,其中包含在特定点的代码中进行的函数调用。 在其他编程语言中有着不同的叫法包括 stack trace, stack traceback, backtrac 等名称, 在 Python 中,我们使用的术语是 Traceback。
当你的程序导致异常时,Python 将打印 Traceback 以帮助你知道哪里出错了。下面是一个例子来说明这种情况
# example.py
def greet (someone ):
print ('Hello, ' + someon )
greet ('Chad')
这里首先定义了函数 greet,然后传入参数 someone,然后函数内,一个 print 语句其中 someon 是一个没有定义的变量,
然后通过 greet ('Chad'),调用刚才定义的 greet 函数,运行之后会出现如下错误信息。
(Python 中的错误信息开头就是 Traceback。)
Traceback (most recent call last ):
File "/Users/chenxiangan/pythonproject/demo/exmpale.py", line 5, in <module>
greet ('Chad')
File "/Users/chenxiangan/pythonproject/demo/exmpale.py", line 3, in greet
print ('Hello, ' + someon )
NameError: name 'someon' is not defined
此错误输出包含诊断问题所需的所有信息。错误输出的最后一行一般会告诉你引发了什么类型的异常,以及关于该异常的一些相关信息。错误信息的前几行指出了引发异常的代码文件以及行数。
在上面的错误信息中,异常类型是 NameError,意思是名称使用了一个没定义的名称(变量、函数、类)的引用。在本例中,引用的名称是 someon。
一般情况下看错误信息的最后一行就能定位到错误的原因。然后在代码中搜索错误提示中的名称"someon",然后发现这是一个拼写错误,然后我们改成 someone 即可。
然而,有些代码的错误信息要比这个复杂的多。
如何阅读 Python 的 Traceback 信息?
当你想确定代码为什么引发异常的时侯,可以根据 Python 的 Traceback 获取许多有用的信息。下面,将列举一些常见的 Traceback,以便理解 Tracebac 中包含的不同信息。
Python Traceback 信息一览
每个 Python 的 Traceback 信息都有几个重要的部分。下图显示了各个组成部分:
在 Python 中,最好从下到上阅读错误信息:
- 蓝框:Traceback 的最后一行为错误消息行。 其中包含引发的异常名称。
- 绿框:异常名称后面是错误消息。 此消息通常包含有用的信息,用于了解引发异常的原因。
- 黄色方框:阅读顺序由下而上,最下面的信息,是抛出错误的最外层的位置,越往上代码调用深度越深。
然后每个出错的文件会有两条错误信息,第一行是 File 后面紧跟着文件的路径,然后是行数,最后是模块或者方法名。
在 Pycharm 中点击文件的链接即可定位到错误的位置。 - 红色下划线:第二行就是实际执行的代码语句了。