引言
本文基于 《Effective Python: 125 Specific Ways to Write Better Python, 3rd Edition》第十章 健壮性 中的 Item 81: assert Internal Assumptions and raise Missed Expectations，旨在深入探讨如何在实际开发中合理使用 assert 和 raise 语句来增强程序的鲁棒性和可维护性。
Python 提供了两种异常处理机制：assert 和 raise，它们分别用于不同的场景。理解它们的适用范围和差异，是编写高质量代码的关键。这篇文章不仅总结书中要点，还将结合笔者在实际项目中的经验，分析它们的最佳实践，并提供可落地的建议。
一、为什么需要区分 assert 和 raise？
二者服务于不同目的，混淆使用会导致难以维护的代码结构
assert 和 raise 虽然都能引发异常，但它们的用途截然不同：
assert是程序员在开发阶段用来验证内部假设的工具，通常用于调试。raise则是对外暴露的 API 中用于报告错误的方式，属于接口的一部分。
如果你在生产环境中用 assert 报告用户输入错误，一旦启用了 -O 模式（优化模式），所有的断言都会被禁用，导致逻辑漏洞。而反过来，如果在内部逻辑中使用 raise，则可能使调用者误以为这是 API 的正常行为，从而做出不必要的错误处理。
实际案例：一个评分系统的两个版本
下面是一个简单的评分类实现，展示了两种写法的区别：
class RatingError(Exception):
pass
# 使用 raise 的对外 API
class Rating:
def __init__(self, max_rating):
if not (max_rating > 0):
raise RatingError("最大评分必须大于 0")
self.max_rating = max_rating
self.ratings = []
def rate(self, rating):
if not (0 < rating <= self.max_rating):
raise RatingError(f"评分 {rating} 超出范围 [1, {self.max_rating}]")
self.ratings.append(rating)
# 使用 assert 的内部逻辑
class RatingInternal:
def __init__(self, max_rating):
assert max_rating > 0, f"初始化失败：max_rating 必须大于 0，当前值为 {max_rating}"
self.max_rating = max_rating
self.ratings = []
def rate(self, rating):
assert 0 < rating <= self.max_rating, f"评分错误：rating 值为 {rating}，超出允许范围"
self.ratings.append(rating)
可以看到，前者适用于外部调用者明确知道输入需要满足条件；后者仅用于内部逻辑的自我保护，不应当由调用者捕获。
二、assert 应该用于哪些场景？
用于验证“开发者认为理所当然”的前提条件
assert 不应该被用于检查用户输入或外部数据流是否合法。它更适合以下几种情况：
- 验证函数参数是否符合预期（如类型、格式）
- 确保某个算法执行前的状态正确
- 辅助调试时定位问题根源
示例：验证函数参数类型
def calculate_area(width, height):
assert isinstance(width, (int, float)) and width > 0
assert isinstance(height, (int, float)) and height > 0
return width * height
这个函数在计算面积之前，先通过 assert 确保传入的参数是正数且为数值类型。如果违反这些假设，说明调用者存在 bug，应尽快暴露出来。
注意事项：
- 不要在生产环境中依赖
assert检查用户输入。 - 不要捕获
AssertionError，除非是为了日志记录或测试。
三、raise 应该如何设计接口异常？
将 raise 视为函数接口的一部分，需清晰文档化
当你的函数需要向调用者报告异常情况时，应优先使用 raise，并定义清晰的自定义异常类。这样可以让调用者更容易理解错误原因，并进行相应的处理。
示例：自定义异常类与清晰错误信息
class InvalidInputError(Exception):
"""表示用户输入不合法"""
pass
def validate_user_input(name, age):
if not name or not isinstance(name, str):
raise InvalidInputError("姓名必须为非空字符串")
if not isinstance(age, int) or age < 0:
raise InvalidInputError("年龄必须为非负整数")
这样的设计不仅让调用者能明确知道什么情况下会抛出异常，也方便自动化测试对错误路径进行覆盖。
最佳实践建议：
- 每个函数都应在 docstring 中注明可能抛出的异常。
- 对外暴露的库函数应尽量使用继承自
Exception的自定义异常。 - 尽量避免直接抛出内置异常（如
ValueError），除非其语义完全匹配。
四、何时应该避免捕获 AssertionError？
不要掩盖代码中的 bug，应尽早暴露问题
虽然技术上可以捕获 AssertionError，但这通常是不推荐的做法。因为 assert 的目的是帮助开发者发现问题，而不是让程序继续运行。
反例：不应该捕获 AssertionError
try:
assert False, "这是一个断言错误"
except AssertionError as e:
print(f"不应该在这里捕获 AssertionError: {e}")
这段代码虽然不会崩溃，但它掩盖了本应被修复的问题。更糟糕的是，如果在生产环境中启用 -O 模式，这段代码甚至不会报错，从而埋下隐患。
正确做法：
- 在开发过程中尽可能多地触发
assert，确保所有内部假设成立。 - 在 CI/CD 流程中加入单元测试覆盖率检测，确保
assert被充分触发。 - 日志系统中记录
AssertionError，以便后续排查。
总结
本文围绕《Effective Python》第 81 条展开，详细解析了 assert 和 raise 的使用场景与区别。总结如下：
assert用于验证内部假设，不应用于对外暴露的错误处理。raise是函数接口的一部分，用于向调用者报告可预期的错误。- 合理使用
assert可提升代码可读性和调试效率。 - 自定义异常类配合
raise能够提高 API 的健壮性。 - 不应捕获
AssertionError，否则可能导致隐藏 bug。
这些原则不仅适用于日常编码，也应在团队协作、代码评审和自动化测试中得到贯彻。只有真正理解它们的用途，才能写出更加稳定、易于维护的 Python 程序。
结语
学习这一条内容让我意识到，良好的错误处理机制不仅是程序健壮性的保障，更是团队沟通的桥梁。assert 和 raise 虽小，却能在关键时刻发挥巨大作用。
如果你觉得这篇文章对你有所帮助，欢迎点赞、收藏、分享给你的朋友！后续我会继续分享更多关于《Effective Python》精读笔记系列，参考我的代码库 effective_python_3rd，一起交流成长！