Allure 2 安装与配置完全指南

2026-01-20 01:51:06作者：段琳惟

Allure Report is a flexible, lightweight multi-language test reporting tool. It provides clear graphical reports and allows everyone involved in the development process to extract the maximum of information from the everyday testing process

项目地址：https://gitcode.com/gh_mirrors/al/allure2

项目基础介绍与主要编程语言

Allure Report 是一个灵活且轻量级的多语言测试报告工具，旨在为软件开发过程中的测试提供清晰的图形化报告。它支持多种测试框架，并跨越多个编程语言，帮助团队成员更高效地理解日常测试的成果。该项目主要采用 Java 作为核心编程语言，并利用一系列现代技术栈构建。

关键技术和框架

多语言支持: 支持TestNG、JUnit等多种测试库。
报告引擎: 提供丰富的数据可视化，包括统计、趋势分析等。
DevOps集成: 与CI/CD系统（如Jenkins）无缝整合，方便自动化测试报告生成。
可扩展性: 通过插件机制支持自定义扩展，例如与JIRA等工具的集成。
跨平台: 支持Windows、macOS和Linux操作系统。
基于Maven和Gradle的构建: 方便项目集成与管理。

安装与配置步骤

准备工作

确保环境: 确保你的机器上已安装Java Development Kit (JDK)，版本建议1.8或更高。
Git客户端: 如果你打算从GitHub克隆项目，需安装Git。
IDE选择: 可选，推荐使用IntelliJ IDEA或Eclipse等支持Maven的IDE以简化开发。

安装步骤

全局安装Allure命令行工具

对于大多数用户，首先安装Allure命令行工具将是开始的一步：

Mac/Linux使用Homebrew安装:
```
brew install allure
```

Windows用户使用Scoop:

安装Scoop（如果尚未安装）:

iex (new-object net.webclient).downloadstring('https://get.scoop.sh')

然后安装Allure:
```
scoop install allure
```

项目集成与报告生成

添加依赖:

对于Maven项目，在pom.xml中添加Allure与对应的测试框架依赖（以TestNG为例）:

<dependency>
    <groupId>org.testng</groupId>
    <artifactId>testng</artifactId>
    <version>6.8.8</version>
    <!-- 或者使用最新版本 -->
    <!-- 注意: 实际操作时应查询最新的TestNG版本 -->
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>io.qameta.allure</groupId>
    <artifactId>allure-testng</artifactId>
    <version>(查看仓库获取最新版本)</version>
    <scope>test</scope>
</dependency>

配置Maven Surefire Plugin: 在pom.xml的<build>标签内，添加Surefire插件配置，以便在测试运行时收集Allure数据:

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>(适用的版本)</version>
            <configuration>
                <properties>
                    <property>
                        <name>listener</name>
                        <value>io.qameta.allure.testng.AllureTestNgListener</value>
                    </property>
                </properties>
            </configuration>
        </plugin>
    </plugins>
</build>

运行测试并生成报告

在终端中，导航到项目根目录并运行测试，Allure数据会被临时保存：
```
mvn clean test
```
生成和查看报告

在测试成功执行后，生成Allure报告：
```
allure serve target/allure-results
```
此命令将启动一个本地服务器，你可以通过浏览器访问报告（通常是http://localhost:8080）。