Allure 报告是什么
Allure 是跨语言测试报告框架：各测试框架通过适配器输出结构化结果，再由 Allure 生成可视化报告。强项是把用例组织成层级（Epic/Feature/Story）、记录步骤与附件、标注严重级与缺陷链接，并基于历史数据画通过率与耗时趋势——把「这轮挂了什么、和上轮比如何」讲清楚。
基本信息
| 适配器 | allure-pytest、allure-junit5、allure-jest 等按框架选择 |
|---|---|
| 原始产物 | allure-results 目录的 JSON 与附件文件 |
| 预览与生成 | allure serve 起本地服务；allure generate 产出静态目录 |
| 结构化标注 | 步骤（step）、层级（Epic/Feature/Story）、严重级（severity） |
| 附件 | 截图、日志、请求响应挂到用例，失败现场一键查看 |
| 历史趋势 | 把上轮 history 目录放回结果目录再生成，才有趋势图 |
最小示例
最小示例
pip install allure-pytest # 安装适配器
pytest --alluredir=allure-results # 运行并产出原始结果
allure serve allure-results # 本地起服务预览
allure generate allure-results -o report # 生成静态报告目录
# CI 流程：先取回上一轮 history，生成后再把新 history 归档，趋势才有连续性典型使用场景
- 回归复盘：一页看清失败分布与阻塞点
- 失败取证：截图、接口日志作为附件直接挂在用例上
- 业务切片：按 Epic/Feature/Story 看各模块质量
- 趋势管理：通过率与耗时曲线识别缓慢劣化
- 缺陷联动：用例挂 issue 链接，关闭前可回溯
- 发版存档：每版报告归档，验收时随版本说明提交
结果目录怎么读
| 文件/目录 | 内容 | 注意 |
|---|---|---|
| *-result.json | 单条用例结果与状态 | 生成报告的输入，勿手工编辑 |
| *-container.json | 前置与步骤容器 | 异常时用于排查生成问题 |
| attachments | 截图、日志等附件 | 体积控制，别拖慢加载 |
| environment.properties | 环境与版本信息 | 报告首页展示，务必填 |
| history | 历史数据 | 跨轮保留才有趋势图 |
生成静态报告时注意别把上轮的 history 一起清掉：归档与生成顺序写进流水线脚本，否则趋势图永远只有一根柱子。
附件可能携带敏感信息（令牌、用户数据）：挂附件前过滤请求头与响应体，报告常在群里直接传播。
用例标题写业务语言而不是函数名：报告是给产品与项目同看的，test_login_2 这样的名字没人能读。