Python开发者使用pytest-html生成美观可视化测试报告

简单来说，pytest-html报告要好看，得搞定几件事：选对pytest版本，用--self-contained-html打包，加自定义CSS，通过hook塞日志和截图，最后别忘了--clean-html清理旧报告。

直接用pytest-html生成的报告，默认那叫一个基础——样式简陋，关键指标缺失，失败用例折叠也不友好，有时甚至JS报错导致页面空白。要想让它“美观”又“可用”，非得手动干预CSS、JS和模板逻辑不可。

安装与基础命令跑不通？检查pytest版本兼容性

pytest-html对pytest版本特别敏感。v4.x不支持pytest 8.0以上，v5.x才开始适配。装错版本的话，--html=report.html参数会被忽略，没报错但也没输出，或者报告里的duration字段全是0，很让人头疼。所以，先确认pytest版本：pytest --version，然后对应安装，比如pytest 8.2就用pip install pytest-html>=5.0.0。另外，避免混用旧插件，比如pip uninstall pytest-html pytest-variables，后者常引发JS冲突。

默认report.html样式丑？用--self-contained-html + 自定义CSS

默认生成的HTML依赖外部CDN加载Bootstrap和Chart.js，内网环境打不开，CDN失效时整个报告白屏或图表消失。用--self-contained-html可以内联所有资源，但CSS仍然简陋。所以，先用--self-contained-html生成自包含报告：pytest --html=report.html --self-contained-html，然后注入自定义样式：新建style.css，写入美化规则，比如.summary td { font-family: 'SFMono-Regular', Consolas; }，再通过--css=style.css注入。注意路径：CSS文件必须与pytest命令执行目录相对，不能用绝对路径或../回退。

想看每个测试的执行时间、日志、截图？得改用pytest的fixture机制

pytest-html默认不记录print()输出，也不记录logging或异常traceback的完整内容。失败用例只显示第一行错误，这显然不够用。想让报告真正可调试，必须主动hook测试生命周期。在conftest.py中定义pytest_runtest_makereport hook，把rep.caplog和rep.longreprtext注入到extra列表。截图需配合selenium或playwright：在except块中调用driver.sa ve_screenshot('screenshot.png')，再用extra.append(pytest_html.extras.image('screenshot.png'))。注意，别直接往rep.extra写字符串，必须用pytest_html.extras.*包装，否则渲染时会报TypeError: object of type 'str' has no len()。

清理这一步，最容易被忽略。每次运行前不删旧报告，新旧数据会叠加进同一份HTML，导致JS渲染混乱、图表错位。建议在pytest.ini里加addopts = --html=report.html --self-contained-html --clean-html（v5.1+支持），或者用shell脚本先rm -f report.html再跑。