在自动化测试中一份清晰、直观、可交互的测试报告是定位问题、分析结果的关键。Allure Report 是一款开源测试报告工具 —— 它支持 pytest、JUnit 等主流测试框架可以生成包含用例详情、步骤、截图、日志交互式的网页报告。本文将基于你提供的内容从安装、环境配置、到 pytest 实战使用带你一步到位掌握 Allure Report一、Allure Report 是什么Allure Report 是一个由框架适配器 Allure 命令行工具组成的开源测试报告框架核心优势在于以极少的配置集成到自动化测试工作流中生成的报告是交互式网页任何人都能轻松阅读无需技术背景支持丰富的测试结果可视化用例通过率、趋势图、失败用例详情、步骤截图、日志嵌入等兼容 pytest、JUnit、TestNG 等几乎所有主流测试框架。二、完整安装步骤Windows 环境Allure 的安装分为两部分Python 适配器allure-pytest 和 Allure 命令行工具两者缺一不可。1. 安装 Python 适配器pytest 插件在你的虚拟环境终端中执行以下命令推荐安装固定版本避免兼容性问题pip install allure-pytest2.13.5安装成功后终端会显示Successfully installed allure-pytest-2.13.5 allure-python-commons-2.13.5这个插件的作用是在 pytest 运行时收集测试结果数据生成 allure-results 目录。2. 安装 Allure 命令行工具步骤 1下载压缩包打开 GitHub 官方发布页下载 Windows 版的 allure-2.30.0.zip 下载链接步骤 2解压到无中文路径将压缩包解压到一个无中文、无空格的路径例如D:\download\allure-2.30.0解压后目录结构如下allure-2.30.0/ ├── bin/ # 核心可执行文件 ├── config/ ├── lib/ └── plugins/步骤 3配置系统环境变量按下 Win R输入 rundll32 sysdm.cpl,EditEnvironmentVariables回车打开「环境变量」窗口。在「系统变量」中找到 Path点击「编辑」。点击「新建」粘贴你的 bin 目录路径例如 D:\download\allure-2.30.0\bin一路点击「确定」保存配置。步骤 4验证安装关闭所有终端窗口重新打开 CMD/PowerShell执行以下命令allure --version如果输出版本号如2.30.0说明配置成功。 常见问题CMD 中能运行 allure但 PyCharm 终端提示 “无法识别命令” 解决方法打开 PyCharm → Settings → Tools → Terminal将 Shell path 改为 C:\Windows\System32\cmd.exe保存后重启 PyCharm 即可。三、Allure Report 使用实战结合 pytest步骤 1运行 pytest 生成结果数据在你的虚拟环境终端中执行 pytest 并指定 --alluredir 参数生成测试结果数据allure serve .\report\执行完成后项目目录下会自动生成report文件夹里面包含测试用例的执行数据。 小技巧可以将命令写入pytest.ini配置文件避免每次手动输入[pytest] addopts -vs --alluredir report --clean-alluredir步骤 2两种方式查看报告方式 1启动本地服务器推荐可实时刷新使用allure serve命令启动本地服务自动在浏览器中打开报告allure serve .\report\也可以指定端口号避免端口冲突allure serve --port 8787 .\report\执行成功后终端会输出服务地址自动在浏览器中打开Starting web server at http://127.0.0.1:8787方式 2生成静态 HTML 文件使用 allure generate 命令将结果数据生成静态网页文件适合分享给他人allure generate .\report\ -o ./allure-report --clean--clean生成报告前清空旧文件生成完成后目录下会出现 allure-report 文件夹打开其中的 index.html 即可查看报告。四、Allure 报告核心功能详解生成的 Allure 报告包含多个核心模块帮你全方位分析测试结果模块作用Overview总览页面显示用例通过率、趋势图、执行时间Categories用例分类按失败原因、严重程度分组Suites用例套件按模块 / 测试类展示用例结构Timeline用例执行时间线分析执行耗时Behaviors行为驱动展示按业务场景分组用例Environment测试环境信息可自定义添加如浏览器版本、环境 URL五、进阶技巧美化你的 Allure 报告1. 添加用例描述与标签使用allure.feature、allure.story、allure.title装饰器给用例添加分类和标题让报告更清晰import allure import pytest allure.feature(登录模块) allure.story(账号密码登录) allure.title(正常账号登录成功) def test_login_success(): assert True2. 失败用例自动截图结合 Selenium在测试失败时自动截图并嵌入报告import allure from selenium.webdriver.common.by import By def test_login(driver): driver.get(https://example.com/login) try: driver.find_element(By.ID, username).send_keys(admin) driver.find_element(By.ID, password).send_keys(123456) driver.find_element(By.ID, loginBtn).click() assert 首页 in driver.title except AssertionError: # 失败时截图 allure.attach( driver.get_screenshot_as_png(), name失败截图, attachment_typeallure.attachment_type.PNG ) raise3. 添加环境信息在report目录下创建environment.properties文件写入测试环境信息BrowserChrome 125.0 BaseURLhttps://test.example.com Python3.10.10 Allure2.30.0生成报告后这些信息会显示在Environment模块中。六、常见问题与避坑指南allure --version 提示 “无法识别命令”原因环境变量配置后未重启终端或路径错误。解决重新打开 CMD检查 Path 中的 bin 路径是否正确。pytest 运行后allure-results为空原因未添加 --alluredir 参数或插件未安装成功。解决检查 allure-pytest 是否安装运行 pytest 时加上 --alluredir./allure-results。打开报告显示 “Nothing to show”原因allure serve 指向的目录为空或数据损坏。解决重新运行 pytest 生成结果数据确保 allure-results 目录不为空。静态报告打开空白原因直接在本地打开 index.html浏览器跨域限制导致静态资源无法加载。解决使用 allure serve 方式打开或部署到本地服务中访问。
