pytest 显示完整 diff 需同时满足：使用 -vv 参数、对象为内置容器或支持序列化的类型（如 dataclass）、pytest 版本 ≥7.0；否则退回单行 AssertionError。
断言失败时默认只显示一行，怎么让 pytest 显示完整 diff？
pytest 默认对 assert 失败只输出单行摘要，比如 AssertionError: assert {'a': 1} == {'a': 2}，根本看不出哪一层嵌套变了。这不是 pytest 偷懒，而是它默认用的是“简洁模式”，得主动打开详细比对。
- 在运行命令里加
-vv（两个 v）：pytest -vv test_file.py，这是最直接的开关 - 如果用
assert比较字典、列表等结构体，pytest 会自动调用内置的差异引擎，逐层标出增删改位置 - 注意：只有在测试函数里写的
assert才受这个控制；自己写的raise AssertionError不走这套逻辑，不会出 diff - Pytest 7.0+ 对嵌套对象（如含 datetime、numpy array）的 diff 支持更好，老版本可能退化成
repr()对比
自定义对象比对不显示字段级差异，怎么让它也进 diff？
pytest 的 diff 只对内置容器（dict、list、tuple、set）和部分标准库类型（如 dataclass、namedtuple）开箱支持。你写了个类，assert obj1 == obj2 失败了，大概率只看到两行 repr()，没 diff。
- 最轻量解法：给类加
__repr__，返回易读字符串，至少能肉眼扫差异 - 真正进 diff 的路只有一条：让对象可序列化为 dict/list——要么继承
dataclass并设eq=True，要么手动实现__dict__属性且不含不可序列化字段 - 别碰
__eq__里手动 raise，那会让 pytest 完全跳过结构对比，直接 fallback 到repr() - 第三方库如
pydantic.BaseModel默认支持字段级 diff，但得确保没用exclude_unset=True这类压缩输出的配置
为什么用了 -vv 还是看不到字符串逐行 diff？
字符串太长或含控制字符时，pytest 会自动折叠，显示成 ... + 123 more，不是你漏了参数，是它做了截断保护。
- 强制展开所有：加
--tb=short不管用，得换--tb=long或干脆--tb=native，但更关键的是加--assert=plain—— 等等，别真加，这会关掉所有智能 diff - 正确做法：用
pytest --maxfail=1 -vv配合print()在 assert 前打点，或者把长字符串赋给变量再 assert，pytest 会对变量名做识别并优先展示其内容 - 多行字符串建议先
.splitlines()转成 list 再 assert，diff 引擎对 list 的逐行标记更稳 - 注意编码：如果字符串含 \uXXXX 转义或 raw 字符串，diff 可能显示乱码，这时用
repr(your_str)包一层再 assert，反而更清晰
CI 环境里 pytest 报错没 diff，本地却有，怎么回事？
不是环境差异，是 CI 启动 pytest 时没传 -vv，或者用了 --tb=auto（默认值）但在管道里被重定向导致输出截断。
立即学习“Python免费学习笔记（深入）”；
- 检查 CI 脚本里 pytest 命令是否带
-vv，光-v不够，必须两个 v - 某些 CI 平台（如 GitHub Actions）默认把 stdout 当作流式日志，遇到超长行会丢后半段，可在命令前加
stdbuf -oL强制行缓冲 - 如果用了
pytest-xdist并开启多进程（-n auto），个别 worker 的输出可能被吞掉，临时禁用 xdist 测试是否恢复 diff - 终极确认法：在 CI 里跑
pytest --help | grep 'verbose'，看是否真加载了 verbose 模式
diff 是否出现，取决于三个东西同时在线：pytest 版本够新、命令带 -vv、被比对象是它认识的结构类型。少一个，就退回原始 AssertionError 那行。很多人卡在第二步，以为装了新 pytest 就自动生效。
