pytest自动发现测试需满足:文件名以test_.py或_test.py命名,函数名以test_开头;类名须以test开头且无__init__方法;不满足则直接跳过。

Pytest 写初级单元测试,不需要继承类、不用写 self.assertXXX,直接用 assert 就行——这是它比 unittest 更轻量的核心原因。
怎么命名测试函数和文件才能被 pytest 自动发现
pytest 默认只运行满足以下任一条件的 Python 文件和函数:
- 文件名以
test_*.py或*_test.py命名(比如test_calculator.py) - 函数名以
test_开头(比如test_add) - 类名以
Test开头且不带__init__(如TestClass),但初级阶段建议先别用类
不满足命名规则,pytest 会直接跳过,连报错都不会有。常见坑是写了 check_add() 或 verify_calculation() ——这些函数不会被识别。
如何写一个能跑通的最简测试用例
假设你有个模块 math_utils.py,里面定义了:
def add(a, b):
return a + b
对应测试文件 test_math_utils.py 只需:
from math_utils import add <p>def test_add(): assert add(2, 3) == 5 assert add(-1, 1) == 0 assert add(0, 0) == 0 </p>
终端执行 pytest(或 pytest test_math_utils.py)就能看到结果。注意:assert 失败时,pytest 会自动打印实际值和期望值,比手动 print 调试高效得多。
为什么 assert 里不能用括号包住整个表达式
这是新手高频翻车点:写成 assert(add(2, 3) == 5) 看似没问题,但 Python 把它解析为 assert (add(2, 3) == 5) ——表面一样,实际在某些旧版本或特殊上下文中可能触发 SyntaxWarning,更严重的是,如果断言失败,pytest 无法提取出清晰的比较左右值,错误信息会变成 AssertionError 而不是 assert 4 == 5 这种可读形式。
务必保持裸 assert 语句,不加外层括号:
- ✅ 正确:
assert add(2, 3) == 5 - ❌ 错误:
assert(add(2, 3) == 5)
如何快速验证测试是否真在起作用
改一下被测函数,让它故意返回错值,比如把 return a + b 改成 return a - b,再跑 pytest。如果测试立刻失败并指出哪一行 assert 不通过,说明测试链路是通的;如果没反应、或提示“0 tests collected”,大概率是命名没对上,或者路径没进对。
真正容易被忽略的,是测试文件和被测模块不在 Python 可导入路径里——比如你在项目根目录外执行 pytest,或没设 PYTHONPATH,这时 ImportError 会静默吞掉测试,导致你以为“测试没写对”,其实是环境没配好。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











