pytest -k 后接字符串按表达式解析，支持and/or/not逻辑，非简单子串匹配；需确保函数名以test_开头、文件命名合规，注意shell转义与缓存问题，推荐先用--collect-only验证。
pytest -k 后面的字符串怎么写才匹配到目标测试
直接写函数名或部分关键词就能匹配，但要注意大小写和空格。pytest 会把 -k 后的字符串当作表达式解析，支持布尔逻辑（and、or、not）和括号，不是简单子串搜索。
比如有测试函数 test_user_login_success 和 test_user_logout，运行 pytest -k "login" 就能匹配前者；但 pytest -k "user login" 实际等价于 pytest -k "user and login"，只有函数名同时含这两个词才会被选中——而 Python 函数名里没有空格，所以这种写法通常不生效。
- 推荐写法：
pytest -k "test_user_login"（精确前缀）、pytest -k "login"（模糊关键词） - 避免写法：
pytest -k "test user login"（会被拆成三个独立词，且默认是and关系） - 组合逻辑示例：
pytest -k "login or logout"、pytest -k "smoke and not slow"
为什么用 -k 匹配不到刚写的测试函数
最常见原因是测试函数没被 pytest 发现：函数名没以 test_ 开头，或者不在 pytest 默认扫描路径下（如当前目录没 __init__.py，或文件名不是 test_*.py 或 *_test.py）。
另一个隐蔽问题是 pytest 缓存了收集结果。改了函数名后直接跑 -k 可能仍沿用旧缓存，导致“明明写了 test_xxx 却不出现”。
立即学习“Python免费学习笔记（深入）”；
- 确认函数命名：
def test_something():—— 必须以test_开头 - 确认文件命名：
test_api.py或api_test.py，不能叫api.py - 清缓存重试：
pytest --cache-clear -k "something" - 先看 pytest 收集了哪些测试：
pytest --collect-only -k "something"，比盲跑更可靠
在 CI 或命令行里用 -k 要注意 shell 字符转义
当关键词含括号、引号或空格时，shell 可能提前解析，导致传给 pytest 的表达式出错。比如 pytest -k "smoke and not (slow or flaky)" 在 zsh/bash 中没问题，但在某些 Windows cmd 环境下括号会被当成命令分隔符。
- Linux/macOS 推荐用单引号包裹：
pytest -k 'smoke and not (slow or flaky)' - Windows PowerShell 里双引号可能被吞掉括号，改用反引号转义或换用 cmd +
^（如pytest -k "smoke and not ^(slow or flaky^)"） - 最稳妥方式：把表达式写进
pytest.ini的addopts里，避免 shell 干预
pytest -k 和 -m 标记方式混用时的优先级
-k 是在 pytest 已收集的所有测试中做二次过滤，而 -m 是在收集阶段就筛选带特定标记的测试。两者可以共存，但顺序无关，最终效果是交集。
例如你有 @pytest.mark.smoke 的测试，其中一部分函数名含 "login"，那么 pytest -m smoke -k login 只运行同时满足两个条件的测试。如果想取并集，得用 -k "smoke or login"（前提是标记名也被当作字符串参与匹配，但默认不会——除非你用 --strict-markers 关闭后，pytest 会把未注册的标记名也当普通字符串处理）。
- 推荐做法：用
-m管理稳定分类（如smoke、integration），用-k做临时调试过滤 - 注意：未注册的标记名在开启
--strict-markers时会报错，此时-k无法靠标记名匹配 - 验证实际运行了哪些测试，始终加
--collect-only看一眼再执行
-k 表达式看着简单，但函数名拼写、文件结构、shell 解析、标记配置这几处稍一疏忽，就会“明明写了却没跑”。最省事的做法是先 --collect-only，眼见为实。 
