Python中是否存在支持输出详细错误信息的断言方法？

Python 标准库没有提供专门面向通用业务代码、自动生成详细错误信息的内置断言实现，不过有几个比你目前尝试过的方案更实用的选择，不需要硬扛手写错误信息的冗余，也不用承担重复实例化unittest.TestCase的性能开销。

可选方案对比 #

• 模块级单例复用unittest断言方法
  你之前测试的性能差，核心开销来自每次调用都新建TestCase实例，完全可以在模块级别创建一个全局单例复用，性能损耗会降到可忽略的程度：

  import unittest
  _assert = unittest.TestCase()
  
  # 业务代码中直接调用即可
  _assert.assertEqual(a, b)
  _assert.assertIsInstance(x, int)
  _assert.assertIn(key, mapping)
  

  实测复用单例后，同等调用的耗时比每次实例化快15倍以上，虽然仍略慢于原生assert带f-string错误信息的写法，但断言本身只在开发调试阶段生效，生产构建时会被完全剥离，这点性能差异对实际开发没有任何影响。注意不要在断言逻辑里写业务生效的校验，断言本来就不该在生产环境触发。

• 极简辅助函数减少手写冗余
  如果不想依赖unittest的逻辑，继续用原生assert完全是合理选择，不需要每次都手写完整的错误信息模板，可以抽一个极轻量的工具函数统一生成提示，不用重写任何断言判断逻辑：

  def cmp_msg(left, right):
      return f"Left value: {left!r}, Right value: {right!r}"
  
  # 调用时
  assert a == b, cmp_msg(a, b)
  

  遇到长变量名、嵌套属性导致行超长的情况，直接把断言拆成多行即可，PEP8 从未要求断言必须写成单行，拆分后的可读性反而更高：

  assert (
      service.config.user_permission.check_result.allowed_ops
      == expected_allowed_operation_list
  ), cmp_msg(service.config.user_permission.check_result.allowed_ops, expected_allowed_operation_list)
  

• 轻量断言库（允许引入依赖时可选）
  如果项目允许引入小型第三方依赖，可以选择专门面向通用校验场景的轻量断言库，比如assertpy，这类库性能接近原生assert，失败时会自动输出两边的值、类型、嵌套结构差异，不需要手动写任何错误信息。注意不要直接用pytest的断言机制，它的错误信息重写能力依赖pytest运行时，脱离pytest环境无法生效。

最终建议 #

如果你的项目严格限制标准库使用，继续用原生assert手写错误信息是完全合规且高效的选择，遇到行超长正常拆分即可，不存在设计问题；如果想省掉写错误信息的重复劳动，优先选模块级单例复用unittest断言的方案，零额外依赖，实现成本极低。
不要每次断言都新建unittest.TestCase实例，这个写法的性能浪费完全来自无意义的重复实例化，属于确实需要避免的不良实践。

内容的提问来源于stack exchange，提问作者Kraigolas