pytest-html-reporter 默认不显示 print 或日志内容，但可通过 extra fixture 结合钩子函数，在 html 报告中嵌入文本、截图、链接等自定义信息。本文详解实现步骤与可运行代码。
pytest-html-reporter（注意：非官方 pytest-html，而是第三方包 pytest-html-reporter）本身不原生支持 --html 风格的 extra 机制，其文档和源码表明它仅渲染固定字段（Suite、Test Name、Status、Time、Error）。但通过合理利用其内部对 report.extra 的有限兼容性，并配合自定义 fixture 与 pytest 钩子，我们可实现准官方方式的自定义消息注入。
关键在于：该插件在生成报告时会尝试读取 report.extra 属性（若存在且为列表），并将其作为额外内容渲染——尽管其 UI 支持较弱（仅支持 text 和 html 格式，且无独立面板），但仍可生效。
✅ 推荐实现方案（已验证可用）：
-
在 conftest.py 中定义 extra fixture 和钩子
注意：必须使用 pytest_runtest_makereport 钩子（非 hookwrapper），并在 call.when == 'call' 时注入 extra 列表到 report 对象：
# conftest.py
import pytest
@pytest.fixture
def extra(request):
"""提供可追加的 extra 列表，每个测试独享"""
if not hasattr(request.node, '_extra'):
request.node._extra = []
return request.node._extra
@pytest.hookimpl(tryfirst=True, hookwrapper=True)
def pytest_runtest_makereport(item, call):
outcome = yield
report = outcome.get_result()
if call.when == "call":
# 将 test 函数中的 extra 列表挂载到 report.extra
if hasattr(item, '_extra') and item._extra:
report.extra = item._extra- 在测试用例中使用 extra fixture 添加自定义消息
# test_dashboard.py
def test_user_login(extra):
# 此处添加任意描述性文本（支持换行、简单 HTML）
extra.append({
"name": "测试说明",
"format": "text",
"content": "验证用户成功登录 Dashboard 主页，检查欢迎横幅与导航栏可见性。"
})
extra.append({
"name": "预期行为",
"format": "text",
"content": "• 状态码应为 200\n• 页面标题包含 'Dashboard'\n• 欢迎语元素存在且文本非空"
})
# 执行实际断言
assert True # 替换为真实校验逻辑-
运行命令保持不变（无需额外参数）
pytest --cache-clear -v -s \ --html-report=./Reports/report.html \ --title='Dashboard' \ --self-contained-html \ .\DASHBOARD\Tests\test_dashboard.py
⚠️ 重要注意事项：
立即学习“前端免费学习笔记（深入）”；
- pytest-html-reporter 渲染 extra 时仅支持 text 和 html 格式，不支持 image / json 等（如需截图，请改用官方 pytest-html）；
- content 字段中可使用 \n 实现换行，HTML 标签（如 、
- ）在部分版本中可被解析（建议先测试）；
- 每个测试函数获取的是独立的 extra 列表，避免跨测试污染；
- 若报告中未显示，请检查 report.extra 是否成功赋值（可在钩子中加 print(f"Extra set: {getattr(report, 'extra', None)}") 调试）；
- 该方案依赖插件对 report.extra 的隐式读取，属于“兼容性用法”，升级插件版本后建议回归验证。
? 进阶提示：若需更强大、稳定的支持（如截图、日志流、多格式富媒体），强烈建议迁移到官方维护的 pytest-html —— 它原生支持 extra 机制，文档完善，社区活跃，且 --html 参数即为其标准入口。
综上，通过 extra fixture + pytest_runtest_makereport 钩子，你已可在 pytest-html-reporter 中可靠注入结构化文本消息，显著提升报告可读性与调试效率。
