pytest-html默认报告简陋，因仅提供基础HTML结构、无响应式设计、字体小、颜色对比弱；美观需通过自定义CSS、JS或Jinja2模板实现，如用--self-contained-html配合custom.css调整表格样式，或--template替换完整模板。
pytest-html 本身不生成“美观”的报告，它只提供基础 HTML 结构；所谓美观必须靠自定义 CSS、JS 或模板干预，否则默认样式简陋且难以适配现代需求。
为什么 pytest-html 默认报告看起来很丑
默认生成的 report.html 使用内联样式和固定 class 名（如 summary、results-table），无响应式设计，字体小、颜色对比弱、无折叠/筛选交互。Pytest-html 的定位是“可用”，不是“好看”——它连 Bootstrap 都没集成。
- 所有样式写死在 Python 源码里（
pytest_html/plugin.py中的_generate_report） - 不支持直接传入外部 CSS 文件路径，只能靠
--html-report-dir+ 手动覆盖或重写模板 - 表格列宽固定，长用例名会撑破容器，移动端完全不可用
如何用 --self-contained-html + 自定义 CSS 快速提升可读性
不用改源码，也不用 fork 插件，只需两步：启用自包含模式 + 注入轻量 CSS 片段。注意 --self-contained-html 会把 CSS Base64 编码进 HTML，适合单文件分发，但无法热更新。
- 运行命令加参数：
pytest --html=report.html --self-contained-html --css=custom.css -
custom.css必须存在且含有效规则，例如调整表格行高和关键字高亮：
table.results-table { font-size: 14px; border-collapse: collapse; }
.results-table td, .results-table th { padding: 8px 12px; border: 1px solid #ddd; }
.results-table tr.pass > td:first-child { background: #d4edda; }
.results-table tr.fail > td:first-child { background: #f8d7da; }
⚠️ 坑：如果 --css 路径错误或 CSS 语法有误，pytest-html 会静默忽略，不报错也不生效。
立即学习“Python免费学习笔记（深入）”；
将 Markdown 文章转换为微信公众号兼容的纯 HTML 格式。当用户要求"转成微信格式"、"生成公众号文章 HTML"、"排版到微信草稿箱"、"微信粘贴格式"时触发。输出带内联样式的纯 HTML，微信编辑器可直接渲染，无需额外适配。支持标题、段落、列表、粗体、行内代码、表格、引用块、代码块、配图的完整转换。
替换完整 HTML 模板实现深度定制（推荐用于 CI 场景）
真正可控的方式是用 --template 指向 Jinja2 模板。pytest-html 从 v3.2+ 支持该参数，模板变量与源码中 context 字典一致（如 {{ tests }}、{{ summary }}）。
- 复制默认模板：
python -c "import pytest_html; print(pytest_html.resources.TEMPLATE)" > report_template.jinja2 - 修改
report_template.jinja2，比如在<head>加入 Bootstrap CDN 和自定义 JS - 运行：
pytest --html=report.html --template=report_template.jinja2
注意：模板中所有原始 HTML 标签需保留（如 {% for test in tests %}），否则渲染失败；{{ test.traceback | safe }} 必须加 | safe，否则 HTML 被转义。
CI 环境下避免样式丢失的关键细节
在 Jenkins/GitLab CI 中生成报告时，常出现 CSS 不加载、图标变方块、JS 报错——根本原因是资源路径解析失败或 CSP 限制。
- 禁用外部资源：不要在模板里写
<link href="https://cdn.jsdelivr.net/...">，CI 内网通常无法访问外网 - 所有 CSS/JS 必须内联或 Base64 编码（
--self-contained-html已做这事，但自定义模板需手动处理） - GitLab Pages 需确保
report.html在根目录，且index.html是软链接或重定向入口，否则路径错乱
最稳妥的做法是：一个 HTML 文件 + 所有样式脚本内联 + 字体用系统默认（不引入 @font-face），这样无论在哪打开都一致。
