8. 错误和异常 — Python 文档

来自菜鸟教程
Python/docs/2.7/tutorial/errors
跳转至:导航、​搜索

8. 错误和异常

到目前为止,错误消息还没有被提及,但是如果您尝试过这些示例,您可能已经看到了一些。 有(至少)两种可区分的错误:语法错误异常

8.1. 语法错误

语法错误,也称为解析错误,可能是您在学习 Python 时遇到的最常见的抱怨类型:

>>> while True print 'Hello world'
  File "<stdin>", line 1
    while True print 'Hello world'
                   ^
SyntaxError: invalid syntax

解析器重复违规行并显示一个小“箭头”,指向检测到错误的行中最早的点。 该错误是由(或至少检测到)在 箭头之前的标记 引起的:在示例中,错误是在关键字 print 处检测到的,因为冒号 (':') 在它之前丢失。 打印文件名和行号,以便您知道在输入来自脚本的情况下在哪里查看。


8.2. 例外

即使语句或表达式在语法上是正确的,当试图执行它时也可能导致错误。 在执行过程中检测到的错误称为 异常 并且不是无条件致命的:您很快就会学习如何在 Python 程序中处理它们。 然而,大多数异常不会由程序处理,并且会导致如下所示的错误消息:

>>> 10 * (1/0)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ZeroDivisionError: integer division or modulo by zero
>>> 4 + spam*3
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
NameError: name 'spam' is not defined
>>> '2' + 2
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: cannot concatenate 'str' and 'int' objects

错误消息的最后一行指示发生了什么。 异常有不同的类型,类型作为消息的一部分打印:示例中的类型是 ZeroDivisionErrorNameErrorTypeError。 作为异常类型打印的字符串是发生的内置异常的名称。 这适用于所有内置异常,但不一定适用于用户定义的异常(尽管这是一个有用的约定)。 标准异常名称是内置标识符(不是保留关键字)。

该行的其余部分提供了基于异常类型及其原因的详细信息。

错误消息的前面部分以堆栈回溯的形式显示了发生异常的上下文。 一般来说,它包含一个列出源代码行的堆栈回溯; 但是,它不会显示从标准输入读取的行。

内置异常列出了内置异常及其含义。


8.3. 处理异常

可以编写处理选定异常的程序。 看下面的例子,它要求用户输入直到输入一个有效的整数,但允许用户中断程序(使用 Control-C 或任何操作系统支持); 请注意,用户生成的中断是通过引发 KeyboardInterrupt 异常来发出信号的。

>>> while True:
...     try:
...         x = int(raw_input("Please enter a number: "))
...         break
...     except ValueError:
...         print "Oops!  That was no valid number.  Try again..."
...

try 语句的工作方式如下。

  • 首先,执行 try 子句tryexcept 关键字之间的语句)。
  • 如果没有异常发生,则跳过except子句并完成try语句的执行。
  • 如果在执行 try 子句期间发生异常,则跳过该子句的其余部分。 然后如果它的类型匹配以except关键字命名的异常,则执行except子句,然后在try语句之后继续执行。
  • 如果发生的异常与 except 子句中指定的异常不匹配,则将其传递给外部 try 语句; 如果未找到处理程序,则为 未处理异常 并且执行将停止并显示如上所示的消息。

一个 try 语句可能有多个 except 子句,为不同的异常指定处理程序。 最多会执行一个处理程序。 处理程序只处理在相应的 try 子句中发生的异常,而不是在同一个 try 语句的其他处理程序中。 一个except子句可以将多个异常命名为一个带括号的元组,例如:

... except (RuntimeError, TypeError, NameError):
...     pass

请注意,此元组周围的括号是必需的,因为 except ValueError, e: 是用于现代 Python 中通常写为 except ValueError as e: 的语法(如下所述)。 仍支持旧语法以实现向后兼容性。 这意味着 except RuntimeError, TypeError 不等同于 except (RuntimeError, TypeError):,而是等同于 except RuntimeError as TypeError:,这不是您想要的。

最后一个 except 子句可以省略异常名称,用作通配符。 使用它时要格外小心,因为用这种方式很容易掩盖真正的编程错误! 它还可以用于打印错误消息,然后重新引发异常(也允许调用者处理异常):

import sys

try:
    f = open('myfile.txt')
    s = f.readline()
    i = int(s.strip())
except IOError as e:
    print "I/O error({0}): {1}".format(e.errno, e.strerror)
except ValueError:
    print "Could not convert data to an integer."
except:
    print "Unexpected error:", sys.exc_info()[0]
    raise

try ... except 语句有一个可选的 else 子句 ,当出现时,它必须跟在所有的 except 子句之后。 如果 try 子句不引发异常,则它对于必须执行的代码很有用。 例如:

for arg in sys.argv[1:]:
    try:
        f = open(arg, 'r')
    except IOError:
        print 'cannot open', arg
    else:
        print arg, 'has', len(f.readlines()), 'lines'
        f.close()

使用 else 子句比向 try 子句添加额外代码要好,因为它避免了意外捕获不是由 保护的代码引发的异常try ... except 语句。

当异常发生时,它可能有一个关联值,也称为异常的 参数 。 参数的存在和类型取决于异常类型。

except 子句可以在异常名称(或元组)之后指定一个变量。 该变量绑定到一个异常实例,参数存储在 instance.args 中。 为方便起见,异常实例定义了 __str__(),因此可以直接打印参数,而无需引用 .args

也可以在引发异常之前先实例化异常,并根据需要向其添加任何属性。

>>> try:
...     raise Exception('spam', 'eggs')
... except Exception as inst:
...     print type(inst)     # the exception instance
...     print inst.args      # arguments stored in .args
...     print inst           # __str__ allows args to be printed directly
...     x, y = inst.args
...     print 'x =', x
...     print 'y =', y
...
<type 'exceptions.Exception'>
('spam', 'eggs')
('spam', 'eggs')
x = spam
y = eggs

如果异常有一个参数,它被打印为未处理异常的消息的最后一部分(“详细信息”)。

异常处理程序不仅处理在 try 子句中立即发生的异常,而且还处理在 try 子句中调用(甚至间接)的函数内部。 例如:

>>> def this_fails():
...     x = 1/0
...
>>> try:
...     this_fails()
... except ZeroDivisionError as detail:
...     print 'Handling run-time error:', detail
...
Handling run-time error: integer division or modulo by zero

8.4. 引发异常

raise 语句允许程序员强制发生指定的异常。 例如:

>>> raise NameError('HiThere')
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
NameError: HiThere

raise 的唯一参数表示要引发的异常。 这必须是异常实例或异常类(从 Exception 派生的类)。

如果您需要确定是否引发异常但不打算处理它,raise 语句的更简单形式允许您重新引发异常:

>>> try:
...     raise NameError('HiThere')
... except NameError:
...     print 'An exception flew by!'
...     raise
...
An exception flew by!
Traceback (most recent call last):
  File "<stdin>", line 2, in <module>
NameError: HiThere

8.5. 用户定义的异常

程序可以通过创建一个新的异常类来命名它们自己的异常(有关 Python 类的更多信息,请参阅 Classes)。 异常通常应该直接或间接地从 Exception 类派生。 例如:

>>> class MyError(Exception):
...     def __init__(self, value):
...         self.value = value
...     def __str__(self):
...         return repr(self.value)
...
>>> try:
...     raise MyError(2*2)
... except MyError as e:
...     print 'My exception occurred, value:', e.value
...
My exception occurred, value: 4
>>> raise MyError('oops!')
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
__main__.MyError: 'oops!'

在此示例中,Exception 的默认 __init__() 已被覆盖。 新行为只是创建 value 属性。 这取代了创建 args 属性的默认行为。

异常类可以被定义为做任何其他类可以做的任何事情,但通常保持简单,通常只提供一些属性,允许异常处理程序提取有关错误的信息。 当创建一个可以引发多个不同错误的模块时,通常的做法是为该模块定义的异常创建一个基类,以及为不同的错误条件创建特定异常类的子类:

class Error(Exception):
    """Base class for exceptions in this module."""
    pass

class InputError(Error):
    """Exception raised for errors in the input.

    Attributes:
        expr -- input expression in which the error occurred
        msg  -- explanation of the error
    """

    def __init__(self, expr, msg):
        self.expr = expr
        self.msg = msg

class TransitionError(Error):
    """Raised when an operation attempts a state transition that's not
    allowed.

    Attributes:
        prev -- state at beginning of transition
        next -- attempted new state
        msg  -- explanation of why the specific transition is not allowed
    """

    def __init__(self, prev, next, msg):
        self.prev = prev
        self.next = next
        self.msg = msg

大多数异常定义的名称以“Error”结尾,类似于标准异常的命名。

许多标准模块定义了自己的异常来报告它们定义的函数中可能发生的错误。 关于类的更多信息在 一章中介绍。


8.6. 定义清理操作

try 语句有另一个可选子句,用于定义必须在所有情况下执行的清理操作。 例如:

>>> try:
...     raise KeyboardInterrupt
... finally:
...     print 'Goodbye, world!'
...
Goodbye, world!
KeyboardInterrupt
Traceback (most recent call last):
  File "<stdin>", line 2, in <module>

finally 子句 总是在离开 try 语句之前执行,无论是否发生异常。 当异常发生在 try 子句中并且没有被 except 子句处理时(或者它发生在 except 或 else[ X165X] 子句),在执行 finally 子句后重新引发。 当 try 语句的任何其他子句通过 break, continue 离开时,finally 子句也会“在出路时”执行] 或 return 语句。 一个更复杂的例子(在同一个 try 语句中有 exceptfinally 子句从 Python 2.5 开始工作):

>>> def divide(x, y):
...     try:
...         result = x / y
...     except ZeroDivisionError:
...         print "division by zero!"
...     else:
...         print "result is", result
...     finally:
...         print "executing finally clause"
...
>>> divide(2, 1)
result is 2
executing finally clause
>>> divide(2, 0)
division by zero!
executing finally clause
>>> divide("2", "1")
executing finally clause
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "<stdin>", line 3, in divide
TypeError: unsupported operand type(s) for /: 'str' and 'str'

如您所见,在任何情况下都会执行 finally 子句。 通过划分两个字符串引发的 TypeError 不会由 except 子句处理,因此在执行 finally 子句后重新引发。

在实际应用中,finally 子句对于释放外部资源(例如文件或网络连接)很有用,无论资源的使用是否成功。


8.7. 预定义的清理操作

一些对象定义了不再需要该对象时要执行的标准清理操作,而不管使用该对象的操作是成功还是失败。 看下面的例子,它试图打开一个文件并将其内容打印到屏幕上。

for line in open("myfile.txt"):
    print line,

这段代码的问题在于,它在代码完成执行后将文件打开的时间不确定。 这在简单脚本中不是问题,但对于较大的应用程序可能是一个问题。 with 语句允许像文件这样的对象以确保它们总是被及时正确地清理的方式使用。

with open("myfile.txt") as f:
    for line in f:
        print line,

语句执行后,文件 f 始终关闭,即使在处理行时遇到问题。 提供预定义清理操作的其他对象将在其文档中指明这一点。