断言应明确指出“什么没满足”“实际是什么”“期望是什么”：用格式化字符串补充变量值；复杂逻辑提取为语义化变量；生产环境用自定义异常替代assert；测试中封装自定义断言函数。
断言失败时，默认报错信息往往只显示 AssertionError 和一行简短提示，缺乏上下文，排查效率低。要让断言更友好，核心是：**明确指出“什么没满足”“实际是什么”“期望是什么”**，而不是仅靠开发者脑补。
用格式化字符串补充关键变量值
直接在 assert 语句中拼接实际值和预期值，是最简单有效的改进方式：
✅ 推荐写法：
assert user.age >= 18, f"用户年龄必须 ≥ 18，但收到 {user.age}"❌ 默认写法（信息不足）：
立即学习“Python免费学习笔记（深入）”；
assert user.age >= 18
这样失败时会清晰看到具体数值，无需进调试器或加 print。
对复杂判断提取成变量并命名
当断言逻辑较长（比如涉及多个字段、嵌套结构或计算），把判断条件本身赋给一个语义化变量，再断言它：
is_valid_email = "@" in user.email and "." in user.email.split("@")[-1]
assert is_valid_email, f"邮箱格式无效：{user.email}（缺少 @ 或域名无点）"好处是：错误信息可读性强，且该变量名本身就成了文档，后续维护也容易理解意图。
用自定义异常替代 assert（适合生产环境）
assert 在 Python 启动时加 -O 参数会被移除，**不适用于需要稳定报错的场景**（如 API 校验）。此时应改用 raise ValueError 等明确异常，并附详细上下文：
if not permissions.get("read"):
raise PermissionError(
f"用户 {user.id} 缺少 'read' 权限，当前权限列表：{list(permissions.keys())}"
)这类异常不会被优化掉，信息可控，也便于上层统一捕获处理。
配合 pytest 使用自定义断言函数
在测试中，可封装常用校验逻辑，内置友好的失败消息：
def assert_status_code(resp, expected: int):
actual = resp.status_code
assert actual == expected, \
f"HTTP 状态码错误：期望 {expected}，实际 {actual}\n响应体：{resp.text[:200]}..."
使用
assert_status_code(response, 201)
既复用逻辑，又确保每次失败都带响应体片段等调试线索，比裸 assert 更稳健。
