Python 教程 / 用 unittest 编写自动测试与边界检查
自动化测试用代码反复检查指定输入的结果或异常,帮助发现修改造成的回归。先定义读者真正需要的行为,再覆盖正常情况、边界和失败路径,不能仅把实现的每一行重复写成检查。
先确定要保护的规则
本例 total 接收非负整数列表,空列表合计为 0,拒绝 bool 和字符串。它不读取文件、不依赖时间或网络,因此可以先独立测试计算规则。类型提示与实际输入验证的区别可参照类型提示与 mypy。
unittest 是 Python 标准库,不需要另外安装。测试类继承 TestCase,文件名与测试方法名以 test_ 开头,方便自动发现。assertEqual 检查结果,assertRaises 检查指定异常,subTest 则把一个测试方法内的多组输入分别标记。接口说明见Python 官方 unittest 文档。
这里的契约是列表,并不承诺接受任意迭代器。函数先用 any 遍历,再用 sum 遍历;一次性生成器可能在第一次遍历时已经耗尽。不要因为某个空输入测试通过,就扩大函数实际支持的输入范围。
保存函数与完整测试文件
新建独立练习目录,使用项目的 Python 3.12 以上环境。先以 UTF-8 保存 expense_math.py:
def total(amounts):
if any(type(x) is not int or x < 0 for x in amounts):
raise ValueError("invalid amount")
return sum(amounts)
再把下面内容保存为同一目录中的 test_expense_math.py。文件不能取名 unittest.py,以免遮蔽标准库:
import unittest
from expense_math import total
class TotalTests(unittest.TestCase):
def test_regular(self):
self.assertEqual(total([3500, 8000, 2500]), 14000)
def test_empty(self):
self.assertEqual(total([]), 0)
def test_invalid(self):
for values in [[-1], [True], ["8000"]]:
with self.subTest(values=values):
with self.assertRaises(ValueError):
total(values)
if __name__ == "__main__":
unittest.main()
在两个文件所在的目录执行:
python -m unittest -v
应显示三个测试方法成功,最后是 OK。test_invalid 中有三个 subTest,但它们不是额外三个顶层测试方法,因此不要把报告中的 Ran 3 tests 误判为只检查了一种错误输入。详细排版和时间随运行环境而变化。
如果显示 Ran 0 tests,先核对工作目录、test_ 文件名和方法名;这不等于所有规则已经通过。如果出现 ModuleNotFoundError,检查 expense_math.py 是否与测试在一起,以及使用的解释器是否正确。若已确认命令名是 python3,则相应使用 python3 -m unittest -v。
主动验证测试能够发现错误
- 仅将返回表达式改成 sum(amounts) + 1,再运行测试。常规合计与空列表测试应失败,执行状态也应失败。
- 恢复 sum(amounts),重新运行,确认又回到 OK。
- 在练习副本中去掉输入验证,再检查负数、布尔和字符串输入的失败报告。完成后恢复完整函数,再次确认成功。
失败分为断言不匹配和意外异常,两者都会使测试失败。删除验证后,负数和 bool 可能被直接合计,字符串则可能触发 TypeError;测试要求的是 ValueError,因此这些路径都不符合约定。
这样的故意修改不是为了积累失败次数,而是确认测试能保护对应规则。不要把故障版本留作最终代码,也不要为让测试通过而把预期值改成错误结果。新增规则时,先写清为什么需要,再增加相应测试。
用独立目录进行 CSV 集成检查
函数测试不能证明 CSV 标题、文件路径和命令行退出状态都正确。下面检查还会运行另一个完整程序,属于集成测试。先从CSV 报告项目的完整程序取得 csv_report.py,保存到当前练习目录;其中代码与输出名称保留原样,不需要翻译标识符。
把以下完整内容保存为 check_csv.py,使用 python check_csv.py 执行。这是 Python 代码,不是 Bash 命令。它先把程序路径变成绝对路径,再在临时目录内准备重复标识输入、运行程序、读取两个输出文件。不会把当前目录已有的报告当作测试输出。
import subprocess
import sys
import tempfile
from pathlib import Path
program = Path("csv_report.py").resolve()
with tempfile.TemporaryDirectory() as folder:
work = Path(folder)
source = work / "expenses-input.csv"
source.write_text("id,category,amount\ne1,food,8000\ne1,food,8000\n", encoding="utf-8")
result = subprocess.run([sys.executable, str(program)], cwd=work, capture_output=True, text=True)
assert result.returncode == 1
assert "food,8000" in (work / "report.csv").read_text(encoding="utf-8")
assert "duplicate id" in (work / "rejected.csv").read_text(encoding="utf-8")
print("CSV integration checks passed")
预期输出:
CSV integration checks passed
两个 e1 中第一条被接受,第二条因 duplicate id 被拒绝,所以报告保留 food,8000,进程退出码为 1。这里退出码 1 是被验证的业务拒绝结果,而集成检查脚本本身应成功结束。只看到 report.csv 存在,不足以证明全部输入成功。
TemporaryDirectory 在上下文退出后清理它自己创建的临时目录,详情见官方临时文件文档。练习程序只应处理独立数据,不能把生产数据库或用户原始报表放进临时清理范围。
这段简短集成脚本使用普通 assert,请不要加 -O 优化参数运行,否则断言会被移除。较完整的测试项目宜放入 unittest 测试用例,以便稳定汇报各项失败。记录解释器版本、命令、已验证的输入与结果,避免把有限测试扩展为所有平台和安装画面都已验证的结论。




