Python开发者如何利用pytest-html生成美观的可视化测试报告？

pytest-html报告需适配pytest版本、启用--self-contained-html、注入自定义CSS、通过hook注入日志截图、并用--clean-html清理旧报告。

直接用 pytest-html 生成的报告默认是基础 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 仍简陋。

• 生成自包含报告：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 测试生命周期。

立即学习“Python免费学习笔记（深入）”；

• 在 conftest.py 中定义 pytest_runtest_makereport hook，把 rep.caplog 和 rep.longreprtext 注入到 extra 列表
• 截图需配合 selenium 或 playwright：在 except 块中调用 driver.save_screenshot("screenshot.png")，再用 extra.append(pytest_html.extras.image("screenshot.png"))
• 别直接往 rep.extra 写字符串，必须用 pytest_html.extras.* 包装，否则渲染时报 TypeError: object of type 'str' has no len()

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