PyCharm中如何让Pytest跨文件断言始终显示<Click to see difference>？

问题现象 #

在PyCharm中使用Pytest时，当断言函数和测试函数位于同一文件时，断言失败会显示清晰的预期值、实际值，以及<Click to see difference>的可视化对比选项；但如果断言函数在其他文件中，失败时仅会输出基础的AssertionError，没有详细的差异信息。

代码示例 #

tmp.py #

from utils.tmp_1 import assert_in_another_file


def test_assert():
    d1 = {
        1: 2,
        3: 4
    }
    d2 = {
        3: 4,
        5: 6
    }
    assert_in_the_same_file(d1, d2)
    # assert_in_another_file(d1, d2)


def assert_in_the_same_file(d1, d2):
    assert d1 == d2

utils/tmp_1.py #

def assert_in_another_file(d1, d2):
    assert d1 == d2

输出差异 #

同文件断言失败输出 #

Expected :{3: 4, 5: 6}
Actual   :{1: 2, 3: 4}
<Click to see difference>

跨文件断言失败输出 #

>       assert d1 == d2
E       AssertionError

原因分析 #

这是PyCharm的功能限制，和Pytest本身无关：

• PyCharm的断言差异对比功能默认仅对测试文件（命名符合test_*规则或被识别为测试文件的脚本）内的断言生效；
• 外部模块中的断言，PyCharm不会自动解析变量值并生成可视化差异；
• 若直接用命令行运行Pytest，无论断言在哪个文件，都会输出完整的预期/实际差异。

解决方法 #

• 启用Pytest原生终端输出
  在PyCharm的Pytest运行配置中，找到Execution标签，勾选Emulate terminal in output console。这样PyCharm会直接展示Pytest的原生输出，所有断言失败都会显示详细差异。

• 将断言逻辑移回测试函数
  修改外部文件的函数，改为返回对比结果，在测试函数内执行断言：

  # utils/tmp_1.py
  def assert_in_another_file(d1, d2):
      return d1 == d2
  
  # tmp.py
  def test_assert():
      d1 = {1:2, 3:4}
      d2 = {3:4, 5:6}
      assert assert_in_another_file(d1, d2), f"Expected {d2}, got {d1}"
  

  此时断言在测试文件内执行，PyCharm会自动生成差异对比选项。

• 标记外部目录为测试源根
  在PyCharm中右键点击包含断言函数的目录（如utils），选择Mark Directory as > Test Sources Root。这样PyCharm会将该目录下的文件视为测试相关文件，启用断言差异对比功能。

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