pytest -m 标签名必须与 @pytest.mark.xxx 中的 xxx 严格字符串相等、大小写敏感，不支持模糊匹配；多标签用 or/and 连接；加 --strict-markers 和在配置文件中声明 markers 可避免拼写错误导致测试被静默跳过。
pytest -m 后面跟的标签名必须和 @pytest.mark.xxx 里的 xxx 完全一致
标签匹配是严格字符串相等，不支持模糊、前缀或正则（除非加 -k）。比如你写了 @pytest.mark.smoke，就必须用 pytest -m smoke，写成 pytest -m "smo*" 或 pytest -m smoke_test 都不会命中。
- 常见错误：在
@pytest.mark.slow上多打一个下划线，变成@pytest.mark.slow_test，但运行时却敲pytest -m slow——没报错，但测试全被跳过，因为没匹配到任何标记 - 标签名区分大小写：
@pytest.mark.API和pytest -m api不匹配 - 如果想一次跑多个标签，用
or连接：pytest -m "smoke or integration"；用and表示同时带两个标记：pytest -m "smoke and windows"
如何避免 pytest 报 “no tests ran” 却不提示标签拼错
pytest 默认对不匹配的 -m 标签静默忽略，既不报错也不警告。看起来像“没找到测试”，实际是标签写错了，但你可能花十分钟检查路径、文件名，最后发现只是 @pytest.mark.unit 写成了 @pytest.mark.unnit。
- 加
--strict-markers参数，让 pytest 在遇到未注册的标记时报错：pytest -m unnit --strict-markers会直接提示Unknown marker 'unnit' - 提前查看当前项目已注册的标记：运行
pytest --markers，它会列出所有被pytest_addoption或pytest_configure注册过的标记（包括内置的skip,xfail） - 自定义标记建议在
pytest.ini或pyproject.toml中显式声明，否则即使用了@pytest.mark.xxx，--strict-markers仍会报未知标记
pytest.ini 里配置 markers 能解决什么问题
不配置的话，自定义标记只是“能用”，但缺乏描述、不参与校验、IDE 也无法识别。配了之后，--strict-markers 才真正生效，且 pytest --markers 会显示你写的说明。
- 在
pytest.ini中添加：
[tool:pytest]
markers =
smoke: end-to-end smoke test
slow: test that takes >1s to run
gpu: requires CUDA device
pyproject.toml，对应写法是：[tool.pytest.ini_options] markers = [ "smoke: end-to-end smoke test", "slow: test that takes >1s to run", ]
@pytest.mark.gpu 虽然能运行，但 pytest --markers 不会显示它，--strict-markers 也会把它当非法标记拦掉用 -m 筛选时，为什么有些测试还是被执行了
因为 -m 只过滤标记，不覆盖其他筛选逻辑。如果你同时用了 -k（关键字匹配）、指定了具体文件或函数，pytest 会取交集——但只要任一条件满足，测试就可能进来。
立即学习“Python免费学习笔记（深入）”；
- 例如：
pytest test_api.py -m smoke -k "login"，只要测试函数名含login或打了smoke标记，就会执行（不是“且”，而是“或”） - 更隐蔽的情况：某个测试没加任何标记，但它所在的文件被显式指定（如
pytest test_slow.py），那它照常运行，-m对它完全无效 - 验证是否真被过滤：加
-v看详细输出，或加--collect-only先看 pytest 打算跑哪些测试，不真正执行
