pytest 默认报错信息简略，需用 -vv 显示行号、–tb=short 控制堆栈、自定义断言消息（如 assert a == b, f”a={a!r}, b={b!r}”），结合 pytest-approx、deepdiff 等工具提升结构化差异识别能力，并注意 ci 环境对日志的截断问题。
pytest 默认报错信息太简略，怎么看清哪行断言失败了
默认情况下 pytest 只显示断言异常类型和一句话描述，比如 AssertionError: assert False，根本看不出是哪个变量、在哪个测试函数、哪一行出的问题。关键不是“有没有报错”，而是“能不能一眼定位到数据差异源头”。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 加
-vv参数：让 pytest 输出完整测试函数名和断言所在行号 - 用
--tb=short或--tb=auto（默认）避免堆栈淹没关键信息；真要深挖再切--tb=long - 对复杂结构比较，别直接
assert a == b，改用assert a == b, f"a={a!r}, b={b!r}"—— 这样失败时能立刻看到两边值 - 如果用的是
pytest-asyncio或pytest-mock，注意它们可能劫持异常展示逻辑，优先确认是否启用了冲突插件
自定义断言失败消息被吞掉，为什么 assert x == y, "msg" 有时不显示
不是所有运行环境都原生支持自定义消息渲染。最常见的是在 ide 内嵌终端（如 pycharm 的 pytest runner）或某些 CI 日志截断场景下，pytest 会把自定义消息当普通字符串处理，甚至丢弃。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 确认 pytest 版本 ≥ 7.0 —— 旧版本对自定义消息的格式化支持不稳定
- 避免在消息里拼接大对象（如
repr(large_dict)），可能导致日志被截断或超长报错被折叠 - 用
pytest.raises(..., match="...")替代手动try/except/assert，它的match参数自带正则匹配 + 清晰上下文 - 如果用
unittest.TestCase混合写法，self.assertEqual(a, b, msg="...")的msg是可靠的，但别和 pytest 原生断言混用
json / 字典嵌套结构断言失败，怎么快速看出 diff
直接 assert dict1 == dict2 失败时只告诉你“不相等”，但不知道是 key 缺失、value 类型不对，还是浮点精度差了 1e-15。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 用
pytest-approx插件处理数值比较：assert actual == pytest.approx(expected, abs=1e-6) - 对 JSON，先用
json.dumps(..., sort_keys=True, indent=2)格式化再比，失败时能肉眼扫出缩进/换行/顺序差异 - 更推荐用
deepdiff库：from deepdiff import DeepDiff; diff = DeepDiff(a, b, ignore_order=True)，它返回结构化差异字典，可直接打印或断言not diff - 注意
DeepDiff默认忽略类型差异（比如"1"vs1），需要显式传ignore_type_in_groups=[(str, int)]才严格校验
CI 环境里测试失败信息被压缩成一行，日志难排查
很多 CI 平台（github Actions、gitlab CI）默认把 stdout/stderr 合并并做行合并，导致多行 traceback 被压成一串不可读的文本。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 在 CI 脚本里加
pytest --tb=short -v --no-header，减少无关输出，突出错误主体 - 用
pytest --log-cli-level=INFO把关键日志打出来，配合代码里Logging.info(f"input: {data}")定位中间态 - 导出为 junit xml：
pytest --junitxml=report.xml，再用 CI 自带的测试报告解析器展示结构化失败详情 - 如果必须看原始 traceback，加
python -m pytest ... 2>&1 | sed 's/n/ /g'（部分 shell 支持）强制换行，但不如前几种稳定
真正卡住人的，往往不是不会写断言，而是没意识到不同执行环境对错误信息的“转义”和“截断”逻辑完全不同——本地跑得通的提示，在 CI 里可能只剩半句话。留个心眼，比事后翻日志强得多。