pytest-html可生成带样式、可折叠、含图表的html报告，但需配置--self-contained-html、--override-ini="console_output_style=classic"或conftest.py中设tbstyle="long"以显示完整traceback，并用--metadata和--override-ini="html_title=..."添加环境信息与自定义标题。
直接用 pytest-html 就能生成带样式、可折叠、含统计图表的 HTML 测试报告，但默认配置容易漏掉关键信息，比如失败用例的完整 traceback 或环境元数据。
安装和基础命令行用法
不是所有 Python 环境都预装了 pytest-html，得先 pip 安装；它依赖 pytest 本身，所以得确保 pytest 已就绪。
- 运行
pip install pytest-html（推荐在项目虚拟环境中执行） - 执行测试并生成报告：
pytest --html=report.html --self-contained-html -
--self-contained-html很关键——它把 CSS/JS 打包进单个 HTML 文件，避免打开时样式丢失 - 不加这个参数，生成的 HTML 会依赖同目录下的
assets/文件夹，移动文件就坏样式
让失败用例显示完整堆栈（避免只看到“...”截断）
默认情况下，pytest-html 对失败用例的 Traceback 做了折叠+截断，点开后可能仍看不到关键行——尤其当异常发生在 fixture 或 parametrize 场景里。
Article To Html
下载
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图，自动匹配视觉风格。触发场景：文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
- 加参数
--tb=short或--tb=long不影响 HTML 报告内容，只影响控制台输出 - 真正起作用的是
--capture=no或-s，但它只影响 stdout/stderr 捕获，不解决 traceback 截断 - 正确做法：用
--html=report.html --self-contained-html --override-ini="console_output_style=classic"，再配合升级到pytest-html>=4.0.0 - 更稳妥的方案是自定义
pytest_configurehook，在conftest.py里设置config.option.tbstyle = "long"，这样 HTML 报告才会渲染完整 traceback
添加环境信息和自定义标题
默认报告顶部只写 “Test Report”，没有 Python 版本、系统、测试时间等上下文，交接或归档时很难追溯。
- 通过
--html=report.html --self-contained-html --metadata=Python,$(python -V) --metadata=Platform,$(uname -s)可注入键值对（Linux/macOS 下 shell 替换有效） - Windows 用户需改用
cmd /c或提前设环境变量，例如：set PYTHON_VER=3.11.5 & pytest --html=report.html --metadata=Python,%PYTHON_VER% - 标题不能仅靠
--title（该参数已被弃用），必须用--override-ini="html_title=MyProject Smoke Test" - 如果用了
pytest-xdist并行执行，metadata 会被各 worker 覆盖，此时应改用pytest_configure+config._metadata.update(...)统一注入
报告体积大、加载慢？注意日志和截图的处理方式
往 HTML 里塞大量 print、logging 或 base64 编码截图，会让单文件超 10MB，浏览器卡顿甚至崩溃。
-
pytest-html默认把stdout和stderr全塞进报告，用--capture=fd（默认）即可，但别手动加--capture=yes，否则会多一层缓冲导致重复输出 - 截图建议存为独立 PNG 文件，用
extra插件（如pytest-html-reporter或自定义 hook）插入相对路径链接，而不是 base64 内联 - 如果非要用内联，务必限制尺寸：
from PIL import Image; img.resize((800, 600))再转 base64，不然一个 4K 截图就能撑爆报告 - 生成后可用
gzip report.html -c > report.html.gz压缩存档，但注意浏览器打不开 .gz，仅用于备份
最常被忽略的一点：多人协作时，没人检查 report.html 是否被 git 提交——它不该进代码仓库，但 CI 脚本里又常忘记清理，久而久之占满磁盘。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
