TestNG 入门教程

在软件测试领域，自动化测试是提高测试效率和质量的重要手段。TestNG（Test Next Generation）是一款功能强大的 Java 测试框架，它继承了 JUnit 的优点，并在此基础上进行了扩展和改进。本教程将带领你快速入门 TestNG，了解其基本概念、常用功能以及如何编写和运行测试用例。

目录#

  1. TestNG 简介
  2. 环境搭建
  3. 基本概念
    • 测试套件（Test Suite）
    • 测试类（Test Class）
    • 测试方法（Test Method）
    • 注解（Annotation）
  4. 编写测试用例
    • 简单测试方法示例
    • 依赖测试
    • 参数化测试
  5. 运行测试
    • 使用 IDE 运行
    • 使用命令行运行
  6. 报告生成
  7. 最佳实践
  8. 参考资料

1. TestNG 简介#

TestNG 是一个开源的测试框架，旨在简化测试的编写和执行。它支持单元测试、集成测试、功能测试等多种测试类型，并且具有丰富的注解功能，使得测试代码更加简洁和易读。TestNG 还提供了强大的测试执行和报告生成功能，方便开发者查看测试结果。

2. 环境搭建#

2.1 安装 Java#

确保你的机器上已经安装了 Java 开发环境（JDK），可以通过 java -version 命令检查安装情况。

2.2 安装 TestNG#

  • Maven 项目：在 pom.xml 文件中添加以下依赖：
<dependency>
    <groupId>org.testng</groupId>
    <artifactId>testng</artifactId>
    <version>7.7.1</version>
    <scope>test</scope>
</dependency>
  • Gradle 项目：在 build.gradle 文件中添加：
testImplementation 'org.testng:testng:7.7.1'

3. 基本概念#

3.1 测试套件（Test Suite）#

测试套件是一组测试类的集合，可以通过 testng.xml 文件来定义。它用于组织和管理测试用例的执行顺序和分组。

3.2 测试类（Test Class）#

一个 Java 类，其中包含多个测试方法。测试类通常以 Test 结尾命名（非强制）。

3.3 测试方法（Test Method）#

测试类中的一个方法，用于执行具体的测试逻辑。

3.4 注解（Annotation）#

TestNG 使用注解来标记测试方法、配置方法等。常用的注解有：

  • @Test：标记一个测试方法。
  • @BeforeClass：在测试类的所有测试方法执行前执行一次。
  • @AfterClass：在测试类的所有测试方法执行后执行一次。
  • @BeforeMethod：在每个测试方法执行前执行。
  • @AfterMethod：在每个测试方法执行后执行。

4. 编写测试用例#

4.1 简单测试方法示例#

import org.testng.Assert;
import org.testng.annotations.Test;
 
public class SimpleTest {
 
    @Test
    public void testAddition() {
        int result = 2 + 3;
        Assert.assertEquals(result, 5);
    }
}

在这个示例中，我们定义了一个测试方法 testAddition，使用 Assert.assertEquals 来验证计算结果是否正确。

4.2 依赖测试#

假设我们有两个测试方法 testMethodA 和 testMethodB，testMethodB 依赖于 testMethodA 的执行结果。

import org.testng.annotations.Test;
 
public class DependencyTest {
 
    @Test
    public void testMethodA() {
        // 模拟一些操作
    }
 
    @Test(dependsOnMethods = {"testMethodA"})
    public void testMethodB() {
        // 只有 testMethodA 执行成功后才会执行
    }
}

4.3 参数化测试#

TestNG 支持参数化测试，通过 @DataProvider 注解提供测试数据。

import org.testng.annotations.DataProvider;
import org.testng.annotations.Test;
 
public class ParameterizedTest {
 
    @DataProvider(name = "testData")
    public Object[][] provideData() {
        return new Object[][]{
                {1, 2, 3},
                {4, 5, 9}
        };
    }
 
    @Test(dataProvider = "testData")
    public void testSum(int num1, int num2, int expected) {
        int result = num1 + num2;
        Assert.assertEquals(result, expected);
    }
}

5. 运行测试#

5.1 使用 IDE 运行（以 IntelliJ IDEA 为例）#

  • 右键点击测试类或测试方法，选择 Run with TestNG。

5.2 使用命令行运行#

  • 先编译测试代码（如果是 Maven 项目，执行 mvn test-compile）。
  • 然后执行 java -cp "path/to/testng.jar;path/to/your/class/files" org.testng.TestNG testng.xml

6. 报告生成#

TestNG 可以生成 HTML 格式的测试报告。在 testng.xml 中添加：

<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd">
<suite name="My Suite">
    <test name="My Test">
        <classes>
            <class name="com.example.SimpleTest"/>
        </classes>
    </test>
    <listeners>
        <listener class-name="org.uncommons.reportng.HTMLReporter"/>
        <listener class-name="org.uncommons.reportng.JUnitXMLReporter"/>
    </listeners>
</suite>

然后运行测试，会在指定目录生成 test-output 文件夹，其中包含 index.html 报告文件。

7. 最佳实践#

  • 合理分组：使用 @Test(groups = {"group1", "group2"}) 对测试方法进行分组，方便管理和执行特定组的测试。
  • 日志记录：结合日志框架（如 Log4j）记录测试过程中的信息，便于调试和问题排查。
  • 持续集成：将 TestNG 测试集成到持续集成工具（如 Jenkins）中，实现自动化测试流程。

8. 参考资料#

希望通过本教程，你能够快速上手 TestNG，开始编写高效的自动化测试用例。如果在学习过程中遇到问题，可以查阅相关文档或在技术社区寻求帮助。

2026-02