Allure2 报告中添加用例标题

---

简介

在 pytest 中使用 allure2 报告，可以为测试用例添加描述，从而生成更详细的测试报告。

Allure 提供了多种等注解，可以描述用例内容、测试步骤等信息，帮助生成结构清晰的报告。

---

Allure 用例描述汇总

方法名	方法参数	参数说明
@allure.epic()	epic 描述	敏捷里面的概念，定义史诗，往下是 feature
@allure.feature()	模块名称	功能点的描述，往下是 story
@allure.story()	用户故事	用户故事，往下是 title
@allure.title(用例的标题)	用例的标题	重命名 html 报告名称
@allure.step()	操作步骤	测试用例的步骤
@allure.testcase()	测试用例的链接地址	对应功能测试用例系统里面的 case
@allure.issue()	缺陷	对应缺陷管理系统里面的链接
@allure.description()	用例描述	测试用例的描述
@allure.severity()	用例等级	blocker，critical，normal，minor，trivial
@allure.link()	链接	定义一个链接，在测试报告展现
@allure.attachment()	附件	报告添加附件

---

Allure2 报告中添加用例标题

Allure 为了让生成的测试报告便于阅读，提供了一种可以为每条用例添加一个便于阅读的标题（可以使用中文标题）的方法。生成的报告展示用例时，就会以设置的标题名展示出来，如图所示。

---

直接使用装饰器添加用例标题

import allure
import pytest

@allure.title("自定义测试用例标题")
def test_with_title():
    assert True

---

用例标题中携带参数

通过占位符的方式传递参数，可以实现测试用例标题参数化，动态生成测试用例标题。

import allure
import pytest

@allure.title("参数化用例标题：参数一：{param1} ，参数二： {param2}")
@pytest.mark.parametrize("param1, param2, expected", [
    (1, 1, 2),
    (0.1, 0.3, 0.4)
])
def test_with_parametrize_title(param1, param2, expected):
    assert param1 + param2 == expected

---

动态更新测试用例标题

@allure.title("原始标题")
def test_with_dynamic_title():
    assert True
    allure.dynamic.title("更改后的新标题")

---

总结

• Allure 用例描述汇总。
• Allure 添加用例标题的方式。