一、文档

allure文档

二、指令

1、运行测试并生成 allure 数据

pytest --alluredir=./allure_results

2、生成并打开报告

allure serve ./allure_results

三、装饰器

3.1 @allure.step装饰器

将函数或方法标记为测试步骤，并在 Allure 报告中展示步骤层级。
直接在测试方法或函数上添加 @allure.step 装饰器，并可自定义步骤名称，支持使用{}占位符。

import allure@allure.step("打开应用首页")
def open_homepage():print("-----------open--------------")pass# 使用 {} 占位符将变量嵌入步骤名称，参数自动填充。
@allure.step("输入用户名和密码: {username},{password}")
def input_username(username, password):print(f"-----------{username}--------------")pass# 步骤可以嵌套，形成清晰的逻辑层级
def test_login():open_homepage()input_username("test_user","1234")

conftest.py与@allure.step结合，显示单独的“前置/后置”树，用于配置初始化和销毁。
conftest.py：

import pytest
import allure@allure.step("step in conftest.py for setup")
def conftest_test():pass@allure.step("step in conftest.py for teardown")
def conftest_test_of_teardown():pass@pytest.fixture(autouse=True)
def fixture_with_conftest_test():conftest_test()yieldconftest_test_of_teardown()

运行结果：

3.2 @allure.description装饰器

为测试用例添加详细描述

1、@allure.description提供描述字符串
2、@allure.description_html添加html格式的描述
3、仅从测试方法的文档字符串获取描述

import pytest
import alluredef test_unicode_in_description():"""unicode描述使用不同的国家语言helloこんにちは你好伙计"""assert 42 == int(6 * 7)@pytest.mark.parametrize("username", ["user1", "user2"])
@allure.description("测试不同用户名的登录兼容性：username={username}")
def test_login_compatibility(username):pass@allure.description_html("""
<h1>添加html格式的描述</h1>
""")
def test_description_html():pass@allure.description("动态描述，可替换开始的描述")
def test_login_change():passallure.dynamic.description("测试用例执行完了，更改描述")

3.3 @allure.title装饰器

使测试标题更具可读性，标题支持占位符并支持动态替换

import pytest
import allure@allure.title("@allure.title使测试标题更具可读性，标题支持占位符并支持动态替换")
def test_with_a_title():assert 2 + 2 == 4@pytest.mark.parametrize("param1,param2,expected", [(1, 1, 2), (1, 3, 5)])
@allure.title("标题包含动态参数：{param1},{param2}")
def test_with_parametrize_title(param1, param2, expected):assert param1 + param2 == expected@allure.title("动态描述，可替换开始的描述")
def test_title_update():passallure.dynamic.title("测试用例执行完了，更改标题")

运行结果：

3.4 @allure.link、@allure.issue 和 @allure.testcase装饰器

用于在Allure报告中添加可点击的链接，提升测试报告的可追溯性。其中@allure.link表示通用资源链接，@allure.issue关联问题追踪系统（Bug/任务），@allure.testcase关联测试用例管理系统

@allure.link("https://github.com/youngyangyang04/leetcode-master", name="项目仓库")
def test_example_for_link():pass@allure.issue("PROJECT-123", "登录失败问题")
def test_login_for_issue():# 假设配置了issue链接模板：https://jira.company.com/browse/{issue}# 报告中将自动生成完整链接。pass@allure.testcase("TC-456", "登录功能验证")
def test_login_for_testcase():# 假设配置了testcase链接模板：https://testrail.company.com/index.php?/cases/view/{testcase}pass

运行结果：

3.5 @allure.epic、@allure.feature 和 @allure.story装饰器

Epic、Feature、Story通常用于行为驱动开发（BDD）中的分层结构。Epic是最大的范围，通常对应大的业务目标；Feature是Epic下面的功能模块；Story则是更小的用户故事或功能点。Tag可能更灵活，用于标记测试的其他属性，比如优先级、模块等。

注解	层级定位	典型用途
@allure.epic	最高层级，表示宏观业务目标或大型项目模块。	描述系统级别的业务需求或长期目标。
@allure.feature	中间层级，属于某个epic下的功能模块。	描述一个独立的功能模块或子系统。
@allure.story	最细层级，属于某个feature下的具体用户故事或功能点。	描述具体的用户场景或需求点（通常对应敏捷开发中的User Story）。
@allure.tag	独立标签，无固定层级，灵活标记任意属性。	补充标记测试的附加属性（如优先级、测试类型、模块等）。

import allure@allure.epic("电商平台")
@allure.feature("订单管理")
@allure.story("用户取消订单")
@allure.tag("smoke", "high-priority")
def test_order_cancellation():pass@allure.feature("feature_1")
def test_example_for_feature():pass@allure.story("story_1")
def test_example_for_story():pass@allure.feature("feature_2")
@allure.story("story_1")
def test_example_mix_feature_and_story():pass@allure.feature("feature_2")
@allure.story("story_2")
def test_example_mix_feature_and_story_2():pass

可以使用如下命令行选项指定不同的测试集（可有多个，以逗号分隔）

--allure-epics xx1,xx2
--allure-features xx1,xx2
--allure-stories xx1,xx2

如：

pytest --alluredir=./allure_results --allure-epics "电商平台"
pytest --alluredir=./allure_results --allure-stories story_1,story_2
pytest --alluredir=./allure_results --allure-features feature_2 --allure-stories story_2 #--allure-features 与 --allure-stories 是“或”关系，满足其一即被执行

3.6 @allure.severity装饰器

用于按严重性级别标记测试用例级别

import allure@allure.severity(allure.severity_level.BLOCKER)
def test_example_for_severity():pass@allure.severity(allure.severity_level.CRITICAL)
def test_example_for_severity():pass

其中severity_level的枚举值如下：

class Severity(str, Enum):BLOCKER = 'blocker'CRITICAL = 'critical'NORMAL = 'normal'MINOR = 'minor'TRIVIAL = 'trivial'

可以使用如下命令行选项指定不同的测试集（可有多个，以逗号分隔）

--allure-severities blocker,critical

注意：这个级别的关系是"或"