Python测试跳过技巧：skip与xfail使用详解

本文深入解析了Python测试中pytest框架的skip与xfail两大核心机制——@pytest.mark.skip用于干净、可追溯地跳过不适宜执行的测试（必须带reason参数，支持类级和条件跳过），而@ pytest.mark.xfail则专为“预期失败”场景设计，让已知缺陷或不稳定功能在运行中失败不报错、意外通过却触发警报，且全程保留setup/teardown执行；文章不仅厘清了二者本质区别、典型用法及常见陷阱（如strict参数缺失、条件逻辑混淆），还提供了命令行快捷控制技巧，帮助开发者精准表达测试意图，大幅提升CI稳定性与问题定位效率。

pytest里用@pytest.mark.skip跳过测试的正确姿势

临时跳过某个测试，不是删代码也不是注释掉——用@pytest.mark.skip最干净，且能留痕。它会在测试报告里明确标出“skipped”，而不是直接消失。

常见错误是只写装饰器不带理由：@pytest.mark.skip会报错，必须加reason参数；否则pytest 7.0+ 直接拒绝运行。

• 正确写法：

  @pytest.mark.skip(reason="接口未上线，暂不执行")

• 跳过整个测试类：把装饰器放在class定义上方
• 条件跳过（比如只在Windows跳）：@pytest.mark.skipif(sys.platform == "win32", reason="仅Linux支持")
• 注意：被skip标记的测试，setup_method和teardown_method都不会执行

xfail不是跳过，是“预期失败”

@pytest.mark.xfail和skip根本不是一回事：它让测试照常跑，但失败了不算错，成功了反而标为“意外通过”（xpass）。适合标记已知bug、待修复功能或不稳定接口。

容易踩的坑是漏掉strict参数。默认strict=False，意味着即使测试意外通过，也只警告不报错；设成strict=True后，意外通过就当失败处理。

• 典型用法：

  @pytest.mark.xfail(reason="API返回格式待调整", strict=True)

• 可以在测试函数里动态标记：pytest.xfail("手动触发xfail")
• xfail不影响setup/teardown，它们仍会执行
• CI里建议配--strict-markers，避免xfail被当成理所当然

命令行临时控制：比改代码更快

改代码标记不如命令行开关灵活，尤其在CI或临时调试时。pytest自带几个关键开关，不用动源码就能批量干预。

注意-k和--ignore的区别：前者是“只运行匹配的”，后者是“彻底不扫描”，后者更快但没那么精细。

• 跳过所有带slow标记的：pytest -m "not slow"
• 只跑被xfail标记的测试：pytest -m xfail
• 忽略整个目录（比如第三方测试）：pytest --ignore=tests/legacy/
• 强制把xfail当失败（等效于strict=True）：pytest --xfail-strict

别混淆skipif和xfail的条件逻辑

两者都支持condition参数，但语义相反：一个说“满足条件就跳过”，一个说“满足条件就标为预期失败”。写反了会导致行为完全偏离预期。

比如想在Python 3.8以下跳过某个新特性测试，用skipif；但如果该特性在3.8下已存在但有bug，就该用xfail并限定版本。

• @pytest.mark.skipif(sys.version_info
• @pytest.mark.xfail(sys.version_info >= (3, 12), reason="3.12中存在回归bug")
• 条件表达式必须是纯Python表达式，不能调用函数（除非函数是内置或从pytest导入的）
• 条件里用sys或platform模块没问题，但别用自定义函数，pytest不会执行它们

真正难的是判断该用skip还是xfail：跳过代表“现在不该测”，xfail代表“现在测了但知道会挂”。选错一个，CI里的失败率和问题定位成本就全乱了。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。