C#参数化测试入门指南（使用xUnit Theory实现高效单元测试）

什么是参数化测试？

传统的单元测试（如 xUnit 中的 [Fact]）每次只能测试一个固定场景。但现实中，我们经常需要对同一个方法传入不同的参数进行多次验证。这时，参数化测试就派上用场了。

在 xUnit 中，参数化测试通过 [Theory] 特性配合数据源（如 [InlineData]、[MemberData] 等）实现，这就是我们常说的 Theory测试。

准备工作：安装 xUnit

首先，你需要创建一个 C# 项目（建议使用 .NET 6 或更高版本），然后通过 NuGet 安装 xUnit 相关包：

dotnet add package xunitdotnet add package xunit.runner.visualstudio

基础示例：使用 [InlineData] 进行简单参数化

假设我们有一个简单的计算器类，包含一个加法方法：

public class Calculator{    public int Add(int a, int b)    {        return a + b;    }}

现在，我们要对 Add 方法进行参数化测试。使用 [Theory] 和 [InlineData] 可以这样写：

using Xunit;public class CalculatorTests{    [Theory]    [InlineData(1, 2, 3)]    [InlineData(0, 0, 0)]    [InlineData(-1, 1, 0)]    [InlineData(100, 200, 300)]    public void Add_ShouldReturnCorrectSum(int a, int b, int expected)    {        // Arrange        var calculator = new Calculator();        // Act        var result = calculator.Add(a, b);        // Assert        Assert.Equal(expected, result);    }}

在这个例子中，Add_ShouldReturnCorrectSum 方法会被执行 4 次，每次传入不同的参数组合。这就是 xUnit参数化的核心优势：一套测试逻辑，多组数据验证。

进阶用法：使用 [MemberData] 提供复杂数据

当测试数据较多或需要动态生成时，可以使用 [MemberData]。它允许你从静态属性或方法中读取测试数据。

public static IEnumerable GetAddTestData(){    yield return new object[] { 1, 2, 3 };    yield return new object[] { -5, 5, 0 };    yield return new object[] { 10, -3, 7 };}[Theory][MemberData(nameof(GetAddTestData))]public void Add_WithMemberData_ShouldWork(int a, int b, int expected){    var calculator = new Calculator();    var result = calculator.Add(a, b);    Assert.Equal(expected, result);}

为什么选择参数化测试？

• 减少重复代码，提高测试可维护性
• 轻松覆盖边界条件和异常情况
• 测试报告更清晰，每组数据独立显示结果
• 非常适合用于验证算法、解析器、转换器等逻辑

小贴士与最佳实践

- 测试方法名应清晰表达意图，例如 Add_WhenInputsArePositive_ShouldReturnSum
- 使用 [ClassData] 可以进一步封装复杂数据提供逻辑
- 避免在参数化测试中引入副作用（如修改全局状态）
- 结合 Visual Studio 或 Rider 的测试运行器，可以直观看到每组参数的测试结果

结语

通过本文，你已经掌握了 C#参数化测试的基本用法，并了解了如何使用 xUnit 的 Theory 特性提升单元测试效率。无论是简单场景还是复杂数据驱动测试，Theory测试都能让你的测试代码更简洁、更强大。赶快在你的项目中尝试吧！

关键词回顾：C#参数化测试、Theory测试、xUnit参数化、单元测试教程。