正确姿势是使用@pytest.mark.skip(reason="说明")跳过测试,必须带reason参数;跳过类加在class上;条件跳过用skipif;xfail用于预期失败且不影响setup/teardown。

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自带几个关键开关,不用动源码就能批量干预。
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构,支持CLI、API、爬虫、Bot、Django等多种项目类型,包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
注意-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里的失败率和问题定位成本就全乱了。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










