@pytest.mark.xfail()标记测试为预期失败：失败显示xfail（不报错），成功显示xpass（意外通过）；缺括号、异常类型不匹配或strict=false时xpass被忽略均可能导致误报红。
用 @pytest.mark.xfail 标记测试函数即可让 pytest 把它当“预期失败”处理——失败不报错，成功反而标为“意外通过”。
为什么加 @pytest.mark.xfail 后测试还报红？
常见原因是没加括号或参数写错：@pytest.mark.xfail 是装饰器，必须带括号（哪怕空括号），否则 pytest 不识别；另外如果函数里抛了未声明的异常类型，也可能绕过 xfail 逻辑。
- ✅ 正确写法：
@pytest.mark.xfail()或带参数如@pytest.mark.xfail(reason="bug #123") - ❌ 错误写法：
@pytest.mark.xfail（缺括号，会被忽略） - ⚠️ 注意：若测试中主动 raise 了
AssertionError以外的异常（比如ValueError），默认不会触发 xfail 的“预期失败”逻辑，需显式加raises=ValueError
@pytest.mark.xfail 的关键参数怎么选？
最常用的是 reason 和 raises，它们决定 pytest 如何判断“算不算预期失败”。
-
reason="描述文字"：仅用于记录原因，不影响行为 -
raises=TypeError：只在抛出该类型异常时视为“预期失败”，其他失败（比如断言失败、KeyError）仍会报错 -
strict=True：把“意外通过”（即本该失败却成功了）也当错误，否则默认只是警告 -
run=False：跳过执行，直接标记为 xfailed（适合暂不能运行的用例）
如何区分 xfailed、xpassed 和 failed？
终端输出里这三类状态颜色和缩写不同，但容易混淆，尤其 xpassed（意外通过）常被当成“测试通过”而忽略问题。
-
xfail：标记了 xfail 且确实失败 → 淡黄色，不中断流程 -
xpassed：标记了 xfail 却成功了 → 红色（或加--strict后报错），说明 bug 可能已修复，或断言写错了 -
failed：没标记 xfail 却失败了 → 红色，真错误 - 运行时加
-rX可专门显示所有 xfailed/xpassed 用例，加--strict能让 xpassed 直接失败
真正容易被忽略的是 strict 参数默认为 False：一个 xfail 测试悄悄通过了，你可能根本没注意到——它不会打断 CI，也不会发告警，除非你主动查 xpassed 行或加了 --strict。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
