异常教程

Python3 错误和异常（长文解析）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

  • 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;
  • 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观

前言

在编程的世界中，错误和异常如同道路上的警示灯——它们提醒开发者代码运行过程中可能遇到的障碍。对于 Python3 开发者而言，理解并掌握如何处理这些“意外事件”是编写健壮、可靠代码的关键。无论是新手还是中级开发者，都需要通过系统学习异常处理机制，避免程序因未预见的错误而崩溃。本文将从基础概念出发，结合代码示例和实际场景，深入讲解 Python3 错误和异常的核心知识，并提供实用技巧帮助读者提升代码质量。

一、错误与异常：概念与区别

1.1 什么是错误？

在编程中，错误（Error） 是程序无法正常运行的根本原因，通常由语法错误、逻辑错误或资源不足等问题引发。例如，拼写错误的变量名、缺少括号的函数调用，或是内存溢出等，都属于错误的范畴。这类问题通常需要开发者手动修复代码才能解决。

1.2 什么是异常？

异常（Exception） 是程序运行时发生的、可被捕捉和处理的“意外事件”。例如，尝试打开一个不存在的文件、除以零、或网络请求超时等。Python 通过异常机制允许开发者在代码中预设“应对策略”，而非让程序直接崩溃。

1.3 两者的核心区别

  • 错误（Error）：通常不可恢复，需要修改代码逻辑或环境配置。
  • 异常（Exception）：可被程序主动捕获和处理，属于“可控的意外”。

比喻：
如果将程序比作一场旅行，错误就像“路线规划错误”（需要重新导航），而异常则是“突发天气变化”——可以通过携带雨伞或调整行程来应对。

二、Python3 异常处理的基础语法

2.1 try-except 块：捕获异常的基石

Python 使用 try 和 except 关键字来定义异常处理逻辑。其基本结构如下：

try:
    # 可能引发异常的代码块
    risky_code()
except SomeException as e:
    # 处理特定类型的异常
    print(f"捕获到异常：{e}")

示例：处理文件读取异常

try:
    with open("nonexistent_file.txt", "r") as f:
        content = f.read()
except FileNotFoundError as e:
    print(f"文件未找到：{e}")

2.2 捕获多种异常类型

通过在 except 后指定多个异常类型，可以处理不同场景的异常：

try:
    result = 10 / 0
except ZeroDivisionError as e:
    print("除以零错误！")
except TypeError as e:
    print(f"类型错误：{e}")

2.3 else 和 finally 子句

  • else：当 try 块未触发任何异常时执行。
  • finally：无论是否发生异常，都会执行（常用于释放资源）。
try:
    with open("data.txt", "r") as f:
        content = f.read()
except FileNotFoundError:
    print("文件不存在！")
else:
    print("文件读取成功！")
finally:
    print("无论是否出错，这里都会执行。")

三、Python3 常见异常类型及处理场景

3.1 常见异常类型列表

以下是一些 Python3 中常用的异常类型及其触发场景：

异常类型触发场景
SyntaxError语法错误（如缺少冒号、括号不匹配）
NameError使用未定义的变量
TypeError操作或函数应用于不正确的类型
ValueError函数参数值合法但不合适（如 int("abc")）
IndexError索引超出序列范围
KeyError字典键不存在
FileNotFoundError文件或目录不存在
ZeroDivisionError除以零

3.2 实战案例：处理用户输入错误

假设需要用户输入一个整数，但可能输入非数字内容：

while True:
    try:
        user_input = input("请输入一个整数：")
        number = int(user_input)
        print(f"您输入的数字是：{number}")
        break
    except ValueError:
        print("输入无效！请输入一个整数。")

解析：

  • try 块尝试将输入转换为整数。
  • 若用户输入非数字（如 "abc"），触发 ValueError，程序捕获异常并提示用户重新输入。

四、自定义异常：扩展 Python 的异常系统

4.1 为什么需要自定义异常？

当 Python 内置异常类型无法准确描述特定场景的错误时，开发者可以通过继承 Exception 类创建自定义异常。例如，一个电商系统需要区分“库存不足”和“支付失败”两种场景：

class InventoryError(Exception):
    """库存相关错误"""
    pass

class PaymentError(Exception):
    """支付相关错误"""
    pass

4.2 抛出自定义异常

在代码中主动抛出异常，可帮助开发者快速定位问题：

def purchase(item, quantity):
    if item.stock < quantity:
        raise InventoryError(f"库存不足：{item.name} 剩余 {item.stock} 件")
    # 其他逻辑...

4.3 完整案例：自定义异常与多层处理

class LoginError(Exception):
    """登录验证失败"""
    pass

def login(username, password):
    if username == "admin" and password == "123456":
        return "登录成功"
    else:
        raise LoginError("用户名或密码错误")

try:
    result = login("admin", "wrong_password")
except LoginError as e:
    print(e)
    # 可添加重试逻辑或记录日志

五、最佳实践与进阶技巧

5.1 避免过度捕获异常

错误模式：

try:
    # 复杂代码块...
except Exception:
    pass  # 直接忽略所有异常

问题：这可能导致关键错误被掩盖，难以调试。
改进：

  • 仅捕获明确预期的异常类型。
  • 在开发阶段保留详细日志，而非直接忽略异常。

5.2 使用 finally 确保资源释放

在文件、数据库连接等资源操作中，finally 确保资源被正确释放：

file = None
try:
    file = open("data.txt", "w")
    file.write("Hello World")
except IOError as e:
    print(f"写入失败：{e}")
finally:
    if file:
        file.close()

5.3 异常链与嵌套处理

在复杂系统中，可通过 raise ... from ... 明确异常来源：

def download_file(url):
    try:
        response = requests.get(url, timeout=5)
    except requests.exceptions.Timeout as e:
        raise ConnectionError("下载超时") from e

六、常见误区与解决方案

6.1 忽略异常的层级关系

Python 异常具有继承关系（如 ZeroDivisionError 继承自 ArithmeticError）。捕获父类异常时，需确保不会遗漏子类的特定处理：

try:
    result = 10 / 0
except ArithmeticError:  # 正确，捕获所有算术错误
    print("算术异常！")

6.2 在 except 中返回或退出程序

错误模式：

def risky_function():
    try:
        # 风险代码...
    except Exception:
        return None  # 直接返回可能掩盖问题

改进：

  • 在捕获异常后，建议记录日志或触发更上层的处理逻辑。

6.3 混淆 assert 与异常处理

assert 语句用于调试阶段的条件检查，而非替代异常处理：

assert x > 0, "x 必须为正数"

try:
    if x <= 0:
        raise ValueError("x 必须为正数")
except ValueError as e:
    handle_error(e)

结论

通过本文的学习，读者已掌握了 Python3 异常处理的核心机制、常见异常类型、自定义异常的实现方法，以及最佳实践原则。在实际开发中，合理运用 try-except 结构、结合日志记录和资源管理，能够显著提升代码的健壮性和可维护性。

关键要点回顾：

  1. 异常是程序运行时的“可控意外”，需主动处理而非忽视。
  2. 通过捕获特定异常类型，可以精准应对不同场景的错误。
  3. 自定义异常能让代码更清晰地表达业务逻辑中的问题。

掌握这些技能后，开发者将能够编写出更可靠、更易调试的 Python 程序，为构建复杂系统奠定坚实基础。

（全文约 1800 字）

最新发布

查看更多文章