为什么需要HTML测试报告？

在Python测试中，TextTestRunner是unittest框架的默认测试运行器，但默认只输出文本结果。HTML测试报告具有以下优势：

• 更直观的可视化测试结果展示
• 支持颜色标记（通过/失败/错误）
• 包含详细的时间统计信息
• 便于分享和存档
• 支持截图和日志附加

环境准备

开始前，请确保安装以下Python包：

pip install unittest
pip install HTMLTestRunner

HTMLTestRunner是TextTestRunner的扩展，专门用于生成HTML格式的测试报告。

创建测试用例

首先创建简单的测试用例：

import unittest

class MathOperationsTest(unittest.TestCase):
    def test_addition(self):
        self.assertEqual(1 + 1, 2)
    
    def test_subtraction(self):
        self.assertEqual(5 - 3, 2)
    
    def test_multiplication(self):
        self.assertEqual(4 * 3, 12)
    
    def test_division(self):
        self.assertEqual(10 / 2, 5)
        with self.assertRaises(ZeroDivisionError):
            value = 1 / 0

if __name__ == '__main__':
    unittest.main()

生成HTML测试报告

使用HTMLTestRunner运行测试并生成报告：

import unittest
from HTMLTestRunner import HTMLTestRunner

# 创建测试套件
test_suite = unittest.TestLoader().loadTestsFromTestCase(MathOperationsTest)

# 配置报告输出
report_file = open('test_report.html', 'w', encoding='utf-8')
runner = HTMLTestRunner(
    stream=report_file,
    title='数学运算测试报告',
    description='测试基本数学运算功能',
    verbosity=2
)

# 运行测试
runner.run(test_suite)
report_file.close()

报告自定义选项

HTMLTestRunner提供多个自定义选项：

示例：

runner = HTMLTestRunner(
    stream=report_file,
    title='高级数学测试报告',
    description='包含所有数学模块的测试结果',
    verbosity=2,
    tester='张测试',
    language='zh-CN'
)

报告示例截图

高级技巧

常见问题解答