如何区分 Python 中的内置异常和自定义异常

简介

Python 的异常处理机制是编写健壮且可靠代码的强大工具。在本教程中，我们将深入探讨 Python 中的异常世界，探究内置异常和自定义异常之间的区别，并学习如何在 Python 程序中有效地处理它们。

探索 Python 中的内置异常

Python 的内置异常层次结构是一项强大的功能，它使开发者能够有效地处理错误和异常情况。这些内置异常在 Python 标准库中预先定义，为处理程序执行期间可能出现的各种类型的错误提供了一种一致的方式。

理解内置异常

Python 的内置异常以层次结构组织，Exception 类作为基类。这种层次结构允许进行更具体、有针对性的异常处理，以及捕获更广泛类别的异常的能力。

Python 中一些常用的内置异常包括：

ValueError：当函数接收到正确类型但不合适的值的参数时引发。
TypeError：当函数应用于不合适类型的对象时引发。
IndexError：当序列索引超出范围时引发。
KeyError：当在字典中找不到键时引发。
FileNotFoundError：当请求的文件或目录不存在时引发。
ZeroDivisionError：当除法或取模运算的第二个参数为零时引发。

处理内置异常

要在 Python 中处理内置异常，可以使用 try-except 块。这使你能够捕获并处理特定的异常，并在发生异常时提供一个备用方案。

try:
    ## 可能引发异常的代码
    result = 10 / 0
except ZeroDivisionError:
    print("错误：除以零")

在上面的示例中，如果发生 ZeroDivisionError，except 块中的代码将被执行，并打印消息 “错误：除以零”。

你也可以在单个 except 块中捕获多个异常，或者使用通用的 Exception 块来捕获任何类型的异常。

classDiagram
    Exception <|-- BaseException
    BaseException <|-- SystemExit
    BaseException <|-- KeyboardInterrupt
    BaseException <|-- GeneratorExit
    BaseException <|-- StandardError
    StandardError <|-- ArithmeticError
    ArithmeticError <|-- ZeroDivisionError
    StandardError <|-- AssertionError
    StandardError <|-- AttributeError
    StandardError <|-- EOFError
    StandardError <|-- EnvironmentError
    EnvironmentError <|-- IOError
    EnvironmentError <|-- OSError
    StandardError <|-- LookupError
    LookupError <|-- IndexError
    LookupError <|-- KeyError
    StandardError <|-- MemoryError
    StandardError <|-- NameError
    NameError <|-- UnboundLocalError
    StandardError <|-- ReferenceError
    StandardError <|-- RuntimeError
    RuntimeError <|-- NotImplementedError
    StandardError <|-- SyntaxError
    StandardError <|-- SystemError
    StandardError <|-- TypeError
    StandardError <|-- ValueError
    ValueError <|-- UnicodeError

上面的 Mermaid 图表展示了 Python 中内置异常的层次结构。

在 Python 中定义自定义异常

虽然 Python 的内置异常涵盖了广泛的错误场景，但有时你可能需要定义自己的自定义异常来处理应用程序中的特定情况。定义自定义异常可以提高代码的可读性和可维护性，并为用户提供更有意义的错误消息。

创建自定义异常

要在 Python 中定义自定义异常，可以创建一个继承自 Exception 类或其子类之一的新类。这使你能够创建针对特定用例量身定制的异常。

class CustomException(Exception):
    pass

在上面的示例中，我们创建了一个名为 CustomException 的新异常类，它继承自 Exception 类。

你还可以向自定义异常类添加其他属性或方法，以提供更多信息或功能。

class InsufficientFundsError(Exception):
    def __init__(self, balance, amount):
        self.balance = balance
        self.amount = amount

    def __str__(self):
        return f"资金不足。当前余额：{self.balance}，请求金额：{self.amount}"

在这个示例中，我们创建了一个名为 InsufficientFundsError 的自定义异常，它将当前余额和请求金额作为属性包含在内。重写了 __str__ 方法以提供更详细的错误消息。

引发自定义异常

要引发自定义异常，可以使用 raise 语句，就像处理内置异常一样。

def withdraw(balance, amount):
    if amount > balance:
        raise InsufficientFundsError(balance, amount)
    else:
        return balance - amount

try:
    new_balance = withdraw(100, 150)
except InsufficientFundsError as e:
    print(e)

在上面的示例中，如果请求的金额超过当前余额，withdraw 函数将引发 InsufficientFundsError。try-except 块捕获自定义异常并打印错误消息。

通过定义和使用自定义异常，可以创建一个更具表现力和自我文档化的代码库，使其他开发人员（或未来的你自己）更容易理解和维护你的应用程序。

有效处理异常

有效的异常处理对于构建健壮且可靠的 Python 应用程序至关重要。通过理解处理异常的最佳实践和技术，你可以编写更具弹性、更易于调试且能提供更好用户体验的代码。

异常处理的最佳实践

捕获特定异常：不要使用通用的 except 块来捕获所有异常，而是尝试捕获你预期要处理的特定异常。这会使你的代码更易于维护和调试。
提供有意义的错误消息：捕获异常时，确保提供清晰且信息丰富的错误消息，帮助用户理解哪里出了问题以及如何解决该问题。
记录异常：除了处理异常，将它们记录下来以供将来参考和调试也是个好习惯。你可以使用 Python 的内置 logging 模块或像 loguru 这样的第三方日志库来实现这一点。
优雅地处理异常：当异常发生时，尝试以一种允许程序继续运行或提供优雅回退的方式来处理它。避免让异常导致整个应用程序崩溃。
避免裸 except 块：捕获所有异常的裸 except 块可能会使诊断和修复问题变得困难。捕获异常时尽量做到具体明确。

异常处理技术

try-except-else-finally：try-except-else-finally 结构提供了一种全面的方式来处理异常。如果在 try 块中没有引发异常，则执行 else 块，并且无论是否引发异常，finally 块都会始终执行。

try:
    result = 10 / 2
except ZeroDivisionError:
    print("错误：除以零")
else:
    print(f"结果：{result}")
finally:
    print("清理代码已执行")

引发异常：除了处理异常，你还可以使用 raise 语句引发自己的异常。当你想表明代码中发生了特定条件时，这很有用。

def divide(a, b):
    if b == 0:
        raise ZeroDivisionError("错误：除以零")
    return a / b

try:
    result = divide(10, 0)
except ZeroDivisionError as e:
    print(e)

上下文管理器：Python 的 with 语句和上下文管理器提供了一种便捷的方式来确保即使在存在异常的情况下资源也能被正确获取和释放。这可以帮助你避免常见的资源管理问题，比如忘记关闭文件或数据库连接。

with open("example.txt", "r") as file:
    content = file.read()
    print(content)

通过遵循这些最佳实践并使用可用的异常处理技术，你可以编写更健壮、更易于维护的 Python 代码，使其能够有效地处理各种类型的异常并从中恢复。

总结

在本教程结束时，你将对 Python 的异常处理系统有更深入的理解，了解内置异常和自定义异常之间的区别，以及如何利用它们编写更可靠、更易于维护的 Python 代码。无论你是 Python 初学者还是有经验的开发者，本指南都将帮助你提升编程技能，将你的 Python 项目提升到一个新的水平。