AssertionError 是 Python 中 assert 语句条件为 False 时抛出的异常，本身不等于测试失败；仅当被 unittest 或 pytest 等框架捕获并报告时，才构成可衡量的测试失败。
AssertionError 是什么，为什么它不等于测试失败
AssertionError 是 Python 运行时抛出的异常，表示某个 assert 语句的条件为 False。但它本身不是“测试失败”的标志——只有在单元测试框架（如 unittest 或 pytest）中被捕捉并报告时，才构成一次可衡量的测试失败。直接运行含 assert 的脚本遇到 AssertionError，只是程序中断；而在 pytest test_x.py 中触发它，才会生成清晰的失败摘要、堆栈和期望/实际值对比。
常见错误现象：
– 在生产代码里写 assert x > 0 试图做输入校验（-O 优化模式下会被完全移除）
– 在 unittest.TestCase 方法里用 assert 而非 self.assertEqual()，导致失败信息简陋、无 diff、不支持自定义消息
在 pytest 中正确断言返回值与异常
pytest 推荐直接使用 Python 内置 assert，但必须理解其行为边界：
- 对简单比较（
assert result == 42）自动提供变量名和值，比self.assertEqual()更简洁 - 检查异常必须用
with pytest.raises(ValueError):块，不能写assert raise ValueError（语法错误） - 检查警告要用
with pytest.warns(DeprecationWarning): - 避免在
assert中调用有副作用的函数（如assert func() == 42），因为-O下该调用会消失，可能掩盖逻辑缺陷
示例：
立即学习“Python免费学习笔记（深入）”；
def test_divide():
assert divide(10, 2) == 5
with pytest.raises(ZeroDivisionError):
divide(10, 0)
unittest.TestCase 里别乱用裸 assert
unittest 的设计哲学是：断言方法负责格式化、计数、兼容性与扩展性。裸 assert 会绕过这些机制：
-
self.assertEqual(a, b)在失败时显示Expected: a, Actual: b和结构化 diff（尤其对 dict/list） -
self.assertIn(item, container)比assert item in container多一行“Container was …”提示 -
self.assertRaises(TypeError, func, arg)支持检查异常属性（如e.args[0]），而with self.assertRaises()块才能获取异常实例 - 某些断言（如
self.assertWarns()）没有对应的裸assert等价写法
错误示范：assert len(items) == 3 → 正确应为 self.assertEqual(len(items), 3)
什么时候不该用 assert，以及如何替代
assert 不是错误处理机制。它的唯一合理用途是：检测「理论上绝不该发生」的内部状态，且仅用于开发/测试阶段。
- 用户输入校验？用
if not condition: raise ValueError("...") - 文件不存在？用
try/except FileNotFoundError，而非assert os.path.exists(path) - 需要日志或恢复逻辑？
assert无法捕获，只能崩溃 - CI 环境跑测试？确保没加
-O参数（会禁用所有assert）
一个容易被忽略的点：pytest 默认开启 --assert=rewrite，会重写 AST 提升 assert 的调试信息；但如果你在 conftest.py 里手动关了它，或者用了非标准加载方式，裸 assert 的报错就会退化成原始的 AssertionError: False，失去所有上下文。
