如何让pytest在错误信息中显式区分空格与制表符？

方法1：自定义可视化断言函数 #

自己写一个辅助函数，把不可见字符转换成直观的可见符号，比如用·代表空格，→代表制表符，空行标注为[空行]。在测试代码中用这个函数替代普通的==断言：

def assert_visible_text_equal(actual, expected):
    def visualize(line):
        # 处理单行的不可见字符
        vis_line = line.replace(' ', '·').replace('\t', '→')
        # 标记空行
        if not line.strip('\n'):
            return '[空行]\n'
        return vis_line

    # 按行处理文本
    actual_vis = ''.join([visualize(line) for line in actual.splitlines(keepends=True)])
    expected_vis = ''.join([visualize(line) for line in expected.splitlines(keepends=True)])
    
    assert actual_vis == expected_vis, f"文本不匹配:\n实际:\n{actual_vis}\n期望:\n{expected_vis}"

示例用法 #

假设你要测试的文本是：

actual = "    \t\n"  # 第一行4个空格，第二行1个制表符，第三行空行
expected = "    \n\n"  # 期望第一行4个空格，第二、三行空行

使用自定义断言后，错误提示会显示：

AssertionError: 文本不匹配:
实际:
····→
[空行]
期望:
····
[空行]

方法2：通过pytest钩子全局修改字符串对比 #

在项目根目录的conftest.py中添加以下代码，让pytest所有字符串断言自动可视化不可见字符，无需修改测试代码：

def pytest_assertrepr_compare(config, op, left, right):
    # 只处理字符串相等性断言
    if op == "==" and isinstance(left, str) and isinstance(right, str):
        def visualize_text(text):
            lines = []
            for line in text.splitlines(keepends=True):
                vis_line = line.replace(' ', '·').replace('\t', '→')
                # 标记空行（仅含换行符的行）
                if line == '\n':
                    vis_line = '[空行]\n'
                lines.append(vis_line)
            return ''.join(lines)
        
        left_vis = visualize_text(left)
        right_vis = visualize_text(right)
        
        if left_vis != right_vis:
            return [
                f"字符串不相等（已可视化不可见字符）:",
                "实际结果:",
                left_vis,
                "期望结果:",
                right_vis
            ]

这样只要测试中用assert actual_str == expected_str，pytest就会自动输出带可视化标记的差异，清晰区分空格、制表符和空行。

方法3：使用原生repr函数快速排查 #

如果只是临时排查，可以直接对比字符串的repr()结果，它会把制表符显示为\t，换行符显示为\n：

assert repr(actual) == repr(expected)

这种方式无需额外代码，但可读性不如自定义可视化，适合快速验证问题。

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