可用 @pytest.mark.xxx 直接装饰测试函数或类,如 @pytest.mark.slow;标签无需预声明但需拼写准确;-m 后加引号表达式精准筛选,如 -m "slow and network";未注册标签会警告但可运行,推荐在 pyproject.toml 中注册以获提示和校验;多标签可叠加使用。

怎么用 @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 的叠加来控制逻辑流程——它们是并列元数据,不是执行栈。










