pytest自定义标记使用教程

本文深入讲解了 pytest 自定义标记（@pytest.mark.xxx）的实用技巧：从快速为测试函数或类添加标签（如 @pytest.mark.slow），到通过带引号的布尔表达式（如 -m "slow and network"）精准筛选测试，规避常见陷阱（如未加引号导致的函数名误匹配）；同时强调虽可不注册标签直接使用，但推荐在 pyproject.toml 中声明以获得警告抑制、IDE 智能补全和拼写校验；还说明多个标记可自由叠加用于复杂分类场景，帮助你构建更清晰、可控、可维护的测试体系。

怎么用 @pytest.mark.xxx 给测试打标签

直接在测试函数或类上方加装饰器就行，比如想标记一个“慢速”测试：

@pytest.mark.slow
def test_api_timeout():
    assert call_external_api() == "ok"

注意：标签名（如 slow）不用提前声明，pytest 遇到就认；但拼写错误、大小写不一致会导致 -m 过滤失效——它不会报错，只是默默跳过。

pytest -m 怎么精准筛选带标签的测试

命令行用 -m 后跟表达式，不是简单字符串匹配：

• pytest -m slow → 运行所有打了 @pytest.mark.slow 的测试
• pytest -m "not slow" → 排除 slow，运行其余
• pytest -m "slow and integration" → 必须同时有这两个标签
• pytest -m "smoke or fast" → 满足其一即可

常见坑：-m smoke 会把函数名含 smoke 的测试也拉进来（比如 test_smoked_bacon），因为 pytest 默认做“名称模糊匹配”。要严格按标签过滤，得加引号：-m "smoke"。

自定义标签需要注册吗？不注册会怎样

不注册也能用，但会收到 PytestUnknownMarkWarning 警告，不影响执行。注册后能禁用未定义标签、支持 IDE 补全、避免手误。注册方式是在 pyproject.toml 或 pytest.ini 里写：

[tool:pytest]
markers =
    slow: marks tests as slow (deselect with '-m "not slow"')
    integration: requires external service

注意：路径必须是项目根目录下的配置文件；如果用了 pyproject.toml，section 名得是 [tool.pytest.ini_options]，否则不生效。

多个 @pytest.mark.xxx 能叠加使用吗

能，而且很常用，比如一个测试既慢又依赖网络：

@pytest.mark.slow
@pytest.mark.network
def test_download_large_file():
    ...

这时 pytest -m "slow and network" 才能命中。但要注意：pytest 不保证标签执行顺序，所以别指望靠多个 @pytest.mark.parametrize 或 @pytest.mark.usefixtures 的叠加来控制逻辑流程——它们是并列元数据，不是执行栈。

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