Python unittest 组合多个测试用例执行方法

背景与执行目标

随着项目规模扩大，自动化测试代码通常会按业务功能拆分为多个独立的测试类。当需要一次性验证多条链路或回归多个模块时，手动逐个运行效率较低且易遗漏。通过 unittest 模块的测试套件机制，能够将分散的测试类打包为单一集合，实现集中调度与统一出报告。

环境准备

该方案完全依赖 Python 标准库，无需安装第三方依赖。建议提前确认运行环境为 Python 3.x，并在编辑器中新建脚本文件（如 test_suite.py）用于存放整合代码。

操作步骤：构建并执行组合测试

第1步：定义被测逻辑与分组测试类

首先编写待测的业务类，并按测试维度划分独立的测试类。每个类继承 unittest.TestCase，建议在 setUp 中初始化实例以保持用例隔离。

class RomanNumeralConverter(object):
  def __init__(self):
    self.digit_map = {"M":1000, "D":500, "C":100, "L":50, "X":10, "V":5, "I":1}

  def convert_to_decimal(self, roman_numeral):
    val = 0
    for char in roman_numeral:
      val += self.digit_map[char]
    return val

import unittest

class RomanNumeralConverterTest(unittest.TestCase):
  def setUp(self):
    self.cvt = RomanNumeralConverter()

  def test_parsing_century(self):
    self.assertEqual(100, self.cvt.convert_to_decimal("C"))

  def test_parsing_millenia(self):
    self.assertEqual(1000, self.cvt.convert_to_decimal("M"))

class RomanNumeralConverterCombo(unittest.TestCase):
  def setUp(self):
    self.cvt = RomanNumeralConverter()

  def test_multi_millenia(self):
    self.assertEqual(4000, self.cvt.convert_to_decimal("MMMM"))

  def test_add_up(self):
    self.assertEqual(2010, self.cvt.convert_to_decimal("MMX"))

第2步：加载测试用例并创建测试套件

通过实例化 unittest.TestLoader 获取加载器，调用 loadTestsFromTestCase() 将指定测试类中的所有 test_ 前缀方法提取为独立套件。随后将多个套件对象传入 unittest.TestSuite 完成合并。

第3步：统一驱动执行并查看报告

使用 unittest.TextTestRunner 接管执行流程。传入参数 verbosity=2 可使控制台逐行打印测试名称与状态，便于快速定位异常点。

if __name__ == "__main__":
  suite1 = unittest.TestLoader().loadTestsFromTestCase(RomanNumeralConverterTest)
  suite2 = unittest.TestLoader().loadTestsFromTestCase(RomanNumeralConverterCombo)
  suite = unittest.TestSuite([suite1, suite2])
  unittest.TextTestRunner(verbosity=2).run(suite)

运行结果与完成判断标准

保存文件后，在终端执行 python test_suite.py。正常输出应包含每项测试的执行状态及最终汇总：

test_parsing_century (__main__.RomanNumeralConverterTest) ... ok
test_parsing_millenia (__main__.RomanNumeralConverterTest) ... ok
test_add_up (__main__.RomanNumeralConverterCombo) ... ok
test_multi_millenia (__main__.RomanNumeralConverterCombo) ... ok

----------------------------------------------------------------------
Ran 4 tests in 0.032s

OK

当控制台末尾明确输出 OK 且各项均标记为 ok 时，即代表合并运行成功，所有断言均已通过。若出现 FAILED 或堆栈报错，请直接对照异常行检查断言值是否与实际返回值一致。

注意事项与排错指引

• 方法命名规则：测试函数必须严格以 test_ 开头，框架默认仅扫描符合该约定的方法进行加载，遗漏命名会导致用例实际未运行。
• 类名大小写匹配：调用 loadTestsFromTestCase 时传入的参数必须与代码中声明的类名完全一致，Python 对大小写敏感，拼写错误会抛出 NameError。
• 断言语法兼容性：早期教程常见 assertEquals，该写法在 Python 3.2 起已被标记为废弃。建议统一迁移至 assertEqual 以确保与现代解释器的稳定兼容。

总结

以上就是Python unittest合并运行多个测试类的详细内容，更多关于Python自动化测试套件管理的资料请关注本站其它相关文章！