直接用 pytest -m "smoke" 可运行所有 @pytest.mark.smoke 标记的用例；支持布尔表达式如 "smoke and not slow"，但需加引号避免 shell 解析错误，标记名含空格或特殊字符时必须引号包裹，且推荐在配置文件中声明 markers 以避免 Unknown marker 警告。
pytest 中用 -m 运行带 mark 的测试用例
直接用 pytest -m "smoke" 就能跑所有打了 @pytest.mark.smoke 的用例。但注意：如果标记名含空格或特殊字符（比如 @pytest.mark("login flow")），必须用引号包裹，且命令里得写成 pytest -m "login flow" —— 不加引号会被 shell 拆成两个独立参数，报错 invalid marker expression。
常见错误是误以为 -m 只支持单个标记，其实它支持布尔表达式：pytest -m "smoke and not slow"、pytest -m "unit or integration" 都合法。但要注意运算符优先级：and 优先级高于 or，复杂逻辑建议加括号，比如 pytest -m "(smoke or regression) and not flaky"。
如何批量运行多个不相关标记的用例
想同时跑 smoke 和 login 标记的用例，不能写 pytest -m smoke login（这会被当成两个独立 marker 表达式，实际只生效最后一个）。正确方式是用 or 显式连接：pytest -m "smoke or login"。
如果标记名本身含下划线或数字（如 @pytest.mark.api_v2），命令中直接写 api_v2 即可，无需转义；但若用了自定义参数化标记（如 @pytest.mark.parametrize("case", ["a", "b"])），-m 对它无效 —— parametrize 是函数级行为，不是 marker。
立即学习“Python免费学习笔记（深入）”；
- 推荐把常用组合写进
pytest.ini，例如：[tool:pytest] markers = smoke: smoke test login: login-related cases api_v2: v2 API endpoints - 这样运行时能获得更清晰的报错提示，比如拼错标记名会提示
Unknown marker 'smok'而非静默忽略
在 CI/CD 中安全传递标记名避免注入风险
CI 脚本里别直接拼接用户输入到 -m 后面，比如 pytest -m "$MARKER" —— 如果 $MARKER 是 smoke or __import__('os').system('rm -rf /')，就可能触发代码执行（虽然 pytest 本身不 eval，但 shell 层已失控）。
安全做法是白名单校验：
ALLOWED_MARKERS = {"smoke", "login", "api_v2", "regression"}
if marker not in ALLOWED_MARKERS:
raise ValueError(f"Invalid marker: {marker}")
os.system(f"pytest -m '{marker}'") 或者更稳妥地用 subprocess.run 传参列表：subprocess.run(["pytest", "-m", marker])，完全绕过 shell 解析。
标记未生效？检查这三个地方
运行后发现用例没被选中，先看是不是以下原因：
- 测试函数没真正应用标记：写了
@pytest.mark.smoke但装饰器在函数体外、缩进错位，或放在了类定义上却忘了加@pytest.mark.usefixtures类级别支持 - pytest 版本太低：
pytest < 6.0对复合表达式（如not slow）支持不全，升级到pytest >= 7.0更稳 - 用例文件名不匹配默认模式：pytest 默认只收集
test_*.py和*_test.py，如果文件叫login_suite.py，得显式指定路径：pytest login_suite.py -m smoke
标记本身不改变用例执行顺序，也不影响 fixture 加载时机 —— 它只是过滤器。真要控制执行流，得靠 --lf、--ff 或自定义 hook。
