直接用 pytest -k "test_function_name" 可匹配单个测试函数，需加引号防 shell 解析，匹配不区分大小写但函数名须按定义书写，且仅作用于已收集的测试节点id。
pytest -k 怎么匹配单个测试函数名
直接用 pytest -k "test_function_name"，但要注意引号和大小写——-k 是按表达式匹配的，不是精确查找。比如你有个函数叫 test_user_login_success，运行 pytest -k "test_user_login_success" 确实能跑它；但如果只写 pytest -k "login"，所有含 login 的测试（包括 test_admin_login_fail）也会被拉进来。
常见错误是漏掉引号，尤其函数名带下划线或数字时：不加引号会被 shell 当作多个参数拆开，报 zsh: no matches found 或类似错误。
- 必须用双引号或单引号包裹整个匹配字符串，避免 shell 解析干扰
- 匹配不区分大小写，但函数名本身是 Python 标识符，实际仍需按定义时的大小写书写
- 如果函数名含空格或特殊字符（极少见），引号更不可省——不过正常 pytest 测试函数名不会这样
为什么 pytest -k test_xxx 有时不生效
最常见原因是路径没对、测试没被发现，或者函数名拼错了。pytest 默认只收集当前目录及子目录下以 test_ 开头或结尾为 _test 的文件里的函数，且函数名必须是 test_* 形式。
比如你在 tests/ 下执行 pytest -k "test_api_v2"，但实际函数在 app/tests/ 里，pytest 就找不到；又或者函数定义是 def api_v2_test():（缺 test_ 前缀），那 -k 再准也没用——它根本不算测试函数。
- 先确认 pytest 能看到目标函数：
pytest --collect-only查看所有被识别的测试项 - 检查当前工作目录是否包含测试文件，必要时用
pytest path/to/test_file.py -k "xxx"显式指定路径 -
-k不会跨文件搜索“未被导入”的函数，只作用于已收集到的测试节点
多个函数名怎么同时匹配
用布尔表达式，比如 pytest -k "test_cache or test_db" 匹配任意含 test_cache 或 test_db 的测试名；pytest -k "test_user and not test_admin" 排除管理员相关测试。
Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。
注意：这里的 and/or/not 是 -k 自己的语法，不是 shell 关键字，所以必须写在引号里，不能拆出来。
- 空格是隐式的
and，-k "test_a test_b"等价于-k "test_a and test_b" - 括号可以分组：
-k "(test_login or test_logout) and v2" - 正则支持有限，别指望
-k "test_.*_v2"这种写法——-k不支持正则，要用--regex扩展或改用pytest -k "test_login_v2"这类字面匹配
和 pytest.main() 在代码里调用的区别
如果你在 Python 脚本里调用 pytest.main()，传 -k 要作为字符串列表元素，不能直接拼成命令行字符串。比如 pytest.main(["-k", "test_user_login_success"]) 是对的；而 pytest.main(["-k test_user_login_success"]) 会被当成一个参数，不生效。
另一个坑是相对路径：脚本中调用 pytest.main() 时，工作目录是脚本所在位置，不是终端当前路径，容易导致测试文件找不到。
- 推荐显式传入测试路径：
pytest.main(["tests/", "-k", "test_xxx"]) - 避免在
__init__.py或非测试模块里调用pytest.main()，可能触发重复收集或 import 冲突 - 调试时加
--tb=short和-v，方便看清到底跑了哪些用例、为什么跳过
真正容易被忽略的是：-k 匹配的是测试节点 ID，不是函数名本身。ID 默认是 test_file.py::test_func 这种格式，所以 -k "test_func" 其实是在整个 ID 字符串里做子串匹配。一旦你用了自定义 ID（比如通过 @pytest.mark.parametrize 生成多个参数化用例），ID 会变长，单纯靠函数名可能匹配不准——这时候得看 --collect-only 输出的真实 ID 来写匹配表达式。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
