掌握C#单元测试中的参数化理论（xUnit参数化测试从入门到精通）

什么是参数化测试？

传统的单元测试（如 xUnit 中的 [Fact]）每次只能测试一种输入情况。但现实开发中，我们往往希望用多种输入组合来验证同一个方法是否始终表现正确。例如：验证一个加法函数是否对 (1,2)、(0,0)、(-1,1) 等都能返回正确结果。

这时，参数化测试就派上用场了！它允许你定义一个测试方法，并传入多组参数，自动运行多次测试，每组参数对应一次独立的测试执行。

xUnit 中的 [Theory] 与 [InlineData]

在 xUnit 测试框架中，我们使用 [Theory] 特性标记参数化测试方法，并配合 [InlineData] 提供具体参数值。

下面是一个简单的例子：验证一个计算两数之和的方法。

using Xunit;public class CalculatorTests{    [Theory]    [InlineData(2, 3, 5)]    [InlineData(0, 0, 0)]    [InlineData(-1, 1, 0)]    [InlineData(100, -50, 50)]    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);    }}// 被测试的类public class Calculator{    public int Add(int a, int b) => a + b;}

在这个例子中：

• [Theory] 表示这是一个参数化测试；
• 每个 [InlineData(...)] 提供一组参数（a, b, expected）；
• 测试方法会自动运行 4 次，每次使用不同的参数组合；
• 如果某次断言失败，xUnit 会明确告诉你哪组参数导致了失败。

更灵活的数据源：[MemberData] 和 [ClassData]

当测试数据较多或需要动态生成时，[InlineData] 可能不够用。xUnit 还支持通过 [MemberData] 或 [ClassData] 从外部提供测试数据。

使用 [MemberData]

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

注意：GetAddTestData 必须是 public static 方法，且返回 IEnumerable 类型。

使用 [ClassData]

你也可以创建一个专门的数据类：

public class AddTestData : TheoryData{    public AddTestData()    {        Add(1, 1, 2);        Add(0, -1, -1);        Add(100, 200, 300);    }}public class CalculatorTests{    [Theory]    [ClassData(typeof(AddTestData))]    public void Add_WithClassData_ShouldWork(int a, int b, int expected)    {        var calc = new Calculator();        var result = calc.Add(a, b);        Assert.Equal(expected, result);    }}

TheoryData<T1, T2, T3> 是 xUnit 提供的便捷基类，让数据组织更清晰、类型更安全。

为什么使用参数化测试？

• ✅ 减少重复代码：避免为每组数据写一个独立的 [Fact] 方法；
• ✅ 提高测试覆盖率：轻松覆盖边界值、异常值、正常值等多种场景；
• ✅ 增强可读性：测试逻辑与数据分离，结构清晰；
• ✅ 便于维护：新增测试用例只需添加一行 [InlineData] 或扩展数据源。

小贴士：常见误区

• ❌ 不要在一个参数化测试中混合完全不相关的逻辑（比如既测加法又测乘法）；
• ✅ 每个 [Theory] 应聚焦于单一功能点；
• ✅ 参数顺序必须与方法签名严格一致；
• ✅ 使用有意义的测试方法名，如 Add_ShouldReturnCorrectSum。

结语

通过本文，你已经掌握了 C# 单元测试中参数化理论的核心用法。无论是使用 [InlineData] 快速测试几组数据，还是借助 [MemberData] 和 [ClassData] 构建复杂测试集，xUnit 都为你提供了强大而灵活的支持。

记住：高质量的单元测试 = 清晰的逻辑 + 充分的参数覆盖。现在，就去为你的项目添加更智能的 xUnit参数化 测试吧！

关键词回顾：C#单元测试、参数化测试、xUnit理论、xUnit参数化