Python Traceback 错误信息解读指南

Python Traceback 错误信息解读指南

在编写 Python 代码时，一旦程序运行出现错误，系统会输出 Traceback（回溯）错误信息。许多初学者面对这些冗长的报错内容时往往感到困惑，不知从何下手。尽管 Traceback 信息看起来复杂，但它包含了诊断和修复代码异常的关键线索，能精准定位到出错的文件及具体行号。因此，掌握阅读 Traceback 的能力至关重要。此外，在技术面试中，Python 异常类型及其含义也是常见考点。接下来，我们将深入解析这一重要机制。

Traceback 基础概念

什么是 Traceback

Traceback 是 Python 用于报告错误的标准格式。在其他编程语言中，它可能被称为 stack trace、stack traceback 或 backtrace，但在 Python 生态中统一称为 Traceback。后文提到的“错误信息”均指代 Traceback。当程序抛出异常时，Python 会自动打印 Traceback 以提示错误发生的位置。以下是一个典型示例。

# example.py
def greet(someone ):
  print('Hello, ' + someon )
 
greet('Chad')

首先定义一个 greet 函数，接收参数 someone。在函数体内，print 语句中使用了未定义的变量 someon。随后通过调用 greet('Chad') 执行该函数，运行后将产生如下错误输出。

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 即可解决问题。

然而，部分代码的错误信息比此例更为复杂。

Traceback 信息阅读方法

如何阅读 Python 的 Traceback 信息？

当需要确定代码引发异常的原因时，Traceback 提供了大量有用信息。下文列举几种常见 Traceback 格式，以助理解其中包含的不同细节。

Python Traceback 信息一览

每个 Python Traceback 都包含几个关键部分。下图展示了各组成部分：

• 蓝框区域：Traceback 的最后一行是错误消息行，包含引发的异常名称。
• 绿框区域：异常名称后的错误消息通常包含有用信息，用于理解异常原因。
• 黄色方框区域：阅读顺序由下而上。最下方的信息表示抛出错误的最外层位置，越往上代码调用深度越深。

每个出错的文件对应两条错误信息：第一行是 File 后紧跟文件路径、行号，最后是模块或方法名。在 PyCharm 中，点击文件链接即可直接定位到错误位置。

红色下划线区域：第二行显示实际执行的代码语句。

Traceback 实战案例分析

一个具体的例子

通过特定的 Traceback 信息，我们可以更好地理解其提供的内容。

以下示例代码用于说明 Python Traceback 所提供的信息。

def who_to_greet(person ):
  return person if person else input ('Greet who? ')

def greet(someone, greeting='Hello'):
  print(greeting + ', ' + who_to_greet (someone ))

def greet_many(people):
  for person in people:
    try:
      greet(person )
    except Exception:
      print ('hi, ' + person )

定义 who_to_greet 函数，接收参数 person，并根据 if 判断返回相应结果。

greet 函数接收 someone 和可选参数 greeting，调用 print 函数。在 print 中调用 who_to_greet 函数并传入 someone 参数。

greet_many() 函数迭代 people 列表并调用 greet 函数。若调用 greet() 引发异常，则打印简单的问候语。

只要输入正确，此代码不会引发异常。

若在 greetings.py 中调用 greet 函数，并传入值（例如 greet('chad', greting='Yo')），将获得以下 Traceback 信息。

Traceback (most recent call last ): File '/Users/chenxiangan/pythonproject/demo/greetings.py', line 17, in <module> greet ('chad',greting ='Yo') TypeError: greet () got an unexpected keyword argument 'greting'

此前我们提到，阅读 Python Traceback 信息应由下而上进行。此处再次演示。

首先查看错误信息的最后一行，从中可知错误类型及原因。

意思是调用 greet() 时使用了未知参数，该参数名为 greting。

接着向上查看，可找到导致异常的具体代码行。本例中为调用 greet 方法的代码。

其上一行提供了代码所在文件路径、行号及所在模块（PyCharm 中可通过点击文件链接定位）。

由于本例未使用其他 Python 模块，因此显示 <module>，表示当前处于执行文件中。

使用不同文件或调用方式执行 greet 方法，得到的 Traceback 信息会有所不同。下面通过文件导入形式执行 greet 方法，观察结果差异。

# example.py 
from greetings import greet 
greet (1)

运行后的结果：

Traceback (most recent call last ): File '/Users/chenxiangan/pythonproject/demo/exmpale.py', line 3, in <module> greet (1) File '/Users/chenxiangan/pythonproject/demo/greetings.py', line 6, in greet print (greeting + ', ' + who_to_greet (someone )) TypeError: can only concatenate str (not 'int') to str

本例引发的异常同样是 TypeError，但消息提供的帮助较小，仅提示字符串只能与字符串拼接，不能与 int 类型拼接。

向上移动，可查看执行代码行及文件行号。此次显示的是正在执行的函数名称 greet()。

继续向上查看执行代码，发现问题是 greet() 函数调用时传入了整数。

嵌套异常处理机制

有时，在引发异常后，其他代码会捕获该异常并导致新的异常。此时，Python 将按接收顺序输出所有异常信息，最外层的异常信息位于 Traceback 内容的最下方。

这看起来可能令人困惑，下面通过具体例子说明。

在 greetings.py 文件中调用 greet_many 方式的具体代码如下：

greet_many (['Chad', 'Dan', 1])

运行后输出的错误信息如下

Hello, Chad Hello, Dan Traceback (most recent call last ): File '/Users/chenxiangan/pythonproject/demo/greetings.py', line 12, in greet_many greet (person ) File '/Users/chenxiangan/pythonproject/demo/greetings.py', line 6, in greet print (greeting + ', ' + who_to_greet (someone )) TypeError: can only concatenate str (not 'int') to str

During handling of the above exception, another exception occurred:

Traceback (most recent call last ): File '/Users/chenxiangan/pythonproject/demo/greetings.py', line 17, in <module> greet_many (['Chad', 'Dan', 1]) File '/Users/chenxiangan/pythonproject/demo/greetings.py', line 14, in greet_many print ('hi, ' + person ) TypeError: can only concatenate str (not 'int') to str

这次内容似乎不同，比之前多了不少，且包含两个 Traceback 块信息。这是什么意思？

注意这句话

During handling of the above exception, another exception occurred:

其含义是：在处理上述异常期间，发生了另一个异常。简单理解即 except 块中的代码出现了异常，从而导致此现象。

本例中，在第三次循环时 person=1，字符串 'hi' 与 1 无法拼接，从而再次引发异常。

查看所有错误信息输出有助于了解异常的真正原因。

有时，仅看最后一个异常及其错误信息可能仍无法看出问题所在。例如本例，直接通过最后异常看不出具体位置，此时需继续向上查看。

到此这篇关于 Python 出错时 Traceback 解读的文章就介绍到这了，更多相关 Python Traceback 内容请搜索本站以前的文章或继续浏览下面的相关文章，希望大家以后多多支持本站！