如何让pytest显示完整错误差异且无需修改测试源码？

我太懂这种痛苦了——验证REST API的JSON响应时，就差一点点的差异被pytest无情截断，点展开还是一堆省略号，根本找不到问题在哪。而且你试过加-vvv没用，命令行运行也一样，确实是pytest的默认截断设置在搞鬼。

下面给你几种完全不用修改测试源码的解决方法，按推荐程度排序：

1. 用pytest配置文件全局生效（最推荐） #

在你的项目根目录，创建或者修改pytest.ini文件（如果已经有setup.cfg或tox.ini也可以用这两个，pytest会自动识别），添加以下内容：

[pytest]
# 关闭断言差异的长度限制，显示完整对比内容
assert_diff_max_len = -1

这个配置对所有测试生效，不管你是用pytest原生的assert断言，还是基于unittest.TestCase的self.assertEqual，都会完整展示JSON的差异细节。

如果你的测试都是继承unittest.TestCase的老代码，还可以额外在conftest.py里加个全局设置（放在项目根目录就行，不算测试源码）：

def pytest_configure(config):
    import unittest
    # 取消unittest断言的差异长度限制
    unittest.TestCase.maxDiff = None

双管齐下，确保万无一失。

2. 命令行临时设置（适合快速测试） #

如果你不想改任何文件，只想临时看一次完整差异，可以用下面两种方式：

方式A：通过pytest的-o参数直接指定配置 #

直接在命令行运行：

pytest -o assert_diff_max_len=-1

方式B：用环境变量临时生效 #

• Linux/macOS：

  export PYTEST_ASSERT_DIFF_MAX_LEN=-1
  pytest
  

• Windows PowerShell：

  $env:PYTEST_ASSERT_DIFF_MAX_LEN=-1
  pytest
  

为什么之前的-vvv没用？ #

最后解释下：-v/-vvv是控制测试的运行日志详细程度，比如显示每个测试的名称、跳过的原因等，但完全不影响断言差异的截断逻辑——所以调这个参数自然解决不了你的问题。

内容的提问来源于stack exchange，提问作者W.P. McNeill