pytest-html 默认报告简陋因其仅生成含内联样式的静态html，无响应式布局、深色模式或交互功能；v4+移除--css参数，旧版可用绝对路径css定制；推荐改用pytest-reportlog+前端渲染方案。
pytest-html 本身不提供“美观”样式，它只生成基础 HTML 报告；所谓美观必须靠自定义 CSS 或换用更现代的替代方案（如 pytest-reportlog + 前端渲染）。
为什么默认 pytest-html 报告看起来简陋？
pytest-html 生成的 report.html 使用内联样式和极简结构，没有响应式布局、深色模式、图表或折叠/展开逻辑。它的定位是“可用”，不是“好看”。浏览器直接打开后常出现文字重叠、表格列宽失控、无搜索过滤、失败堆栈挤成一团等问题。
- 默认不加载外部 CSS，所有样式写在
<style></style>标签里，难以覆盖 - 不支持动态交互（比如点击测试项展开日志）
-
--self-contained-html会把图片 base64 内联，但 JS/CSS 仍不可定制 - 新版（v4+）移除了
--css参数，官方明确不鼓励样式定制
如何用 --css 参数注入自定义样式（仅限 pytest-html
如果你用的是旧版（例如 pytest-html==3.2.0），可通过 --css 指定本地 CSS 文件强行美化。注意：路径必须是绝对路径，且 CSS 选择器需匹配其生成的 class 名（如 .results-table、.test-row-failed）。
- 运行命令：
pytest --html=report.html --css=custom.css -
custom.css中可重写：.summary { background: #f8f9fa; padding: 1rem; border-radius: 4px; } - 避免用
!important，优先提高选择器权重（如body .test-row-failed） - 图标需转为 base64 或托管在本地服务器（因报告是静态文件，相对路径易失效）
更靠谱的替代方案：用 pytest-reportlog + 自研前端
pytest-html 已停滞维护，推荐改用 pytest 内置的 --report-log（pytest 7.0+），它输出结构化 JSON，再用轻量前端（如 Vue/Vanilla JS）渲染成真正美观的报告。
- 生成日志：
pytest --report-log=report.json -
report.json包含完整测试生命周期（setup/call/teardown）、耗时、错误详情、stdout/stderr 分离字段 - 用
prettier格式化 JSON 后人工检查字段结构，再写 JS 渲染逻辑（比如按状态着色、按模块折叠、搜索框过滤test_id） - 零样式冲突，可直接用 Tailwind 或 Bootstrap，响应式、暗色模式、图表（Chart.js）全自主控制
容易被忽略的关键点
无论选哪种方式，有三个实际落地时总被跳过的细节：
- CI 环境中
--html路径权限问题：Jenkins/GitLab Runner 默认工作目录可能不可写，要用绝对路径并确保目录存在（mkdir -p ./reports） - HTML 报告里的截图路径是相对的，若用
selenium截图，得把图片和 HTML 放同级目录，否则显示为红叉 - pytest-html 不处理非 ASCII 字符（如中文测试名、错误信息），需在
pytest.ini加python_files = test_*.py并确保文件保存为 UTF-8，否则报告里出现
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
