Python unittest结合HTMLTestRunner生成测试报告详解

周予安

发布时间：2026-10-14 | 5人浏览过

原创

本文详细解析如何使用Python的unittest框架结合HTMLTestRunner模块生成可视化的测试报告。内容涵盖从模块导入、单用例执行到批量用例发现的完整流程，重点讲解HTMLTestRunner类中stream、title及description等关键参数的配置方法，帮助开发者快速实现测试结果的HTML化输出与归档。

HTMLTestRunner模块导入与准备

首先，需要在代码中导入HTMLTestRunner模块以启用报告生成功能。

关于如何生成或获取HTMLTestRunner模块的具体方法，请参考相关的模块生成教程。

接下来通过具体实例演示操作流程。

单用例执行与报告生成

第一种场景是执行单个用例文件并生成对应的测试报告。


import unittest
import HTMLTestRunner

class Study01(unittest.TestCase):

  def test01(self):
    print "test01"

  def test02(self):
    self.assertEqual(1,2,msg="1 != 2")

  def test03(self):
    print "test03"

  def test04(self):
    print "test04"

if __name__ == '__main__':
  testcases = [Study01("test01"),Study01("test02"),Study01("test03"),Study01("test04")]
  suit = unittest.TestSuite()
  suit.addTests(testcases)
  #测试报告生成
  dir = "D:\\test.html"  #定义测试报告文件
  filename = open(dir,"wb")  #"wb"新建或者打开一个二进制文件，写入执行完的数据
  runner = HTMLTestRunner.HTMLTestRunner(stream=filename,
                      title="Testcase Report",
                      description=u"测试用例明细")  #调用HTMLTestRunner类定义测试报告内容
  runner.run(suit)  #调用HTMLTestRunner类下面的run()方法运行用例套件
  filename.close()  #关闭测试报告文件

批量用例执行与报告生成

第二种场景是批量执行多个用例文件，并统一生成汇总的测试报告。


import unittest
import HTMLTestRunner

def all_case():

  case_dir = "D:\work_doc\pycharm2\python_Basics" #用例存放路径
  discover=unittest.defaultTestLoader.discover(case_dir,                     pattern="XFS*.py",                      top_level_dir=None)
  return discover
if __name__ == "__main__":
  dir = "d:\\test1.html"
  filename = open(dir,"wb")
  runner = HTMLTestRunner.HTMLTestRunner(stream=filename,                     title="Test Report",                    description="description")
  runner.run(all_case())