如何在NUnit C#中结合TestCaseAttribute与ValuesAttribute实现带TestName的多参数组合测试

你遇到的核心问题是：xUnit不允许在同一个测试方法上混合使用TestCaseAttribute和ValuesAttribute。原因很直接：TestCase要求为测试方法的所有参数提供完整的参数组，你只传了precision和scale两个参数，但方法需要三个参数（加上onlyPositive），所以会抛出参数数量不匹配的异常；如果手动在TestCase里补第三个参数，ValuesAttribute会被直接忽略——因为TestCase已经明确指定了该参数的值，不会再去遍历Values里的选项。

要实现你想要的效果：让每个precision+scale组合分别与onlyPositive的true/false配对，同时保留自定义测试名称，推荐用xUnit的MemberDataAttribute来定义所有参数组合，同时为每个组合设置自定义名称。

具体实现步骤 #

1. 定义静态成员提供测试数据：在测试类中添加一个静态方法/属性，返回所有需要的参数组合，每个组合包含precision、scale、onlyPositive，以及对应的自定义测试名称。
2. 修改测试方法使用MemberData：替换原有的TestCaseAttribute为MemberDataAttribute，并通过DisplayAttribute指定用自定义名称作为测试显示名。

代码示例 #

using Xunit;
using FluentAssertions;
using System;
using System.Collections.Generic;

public class NumberValidatorTests
{
    // 生成所有需要的测试参数组合，包含自定义测试名称
    public static IEnumerable<object[]> ValidConstructorArguments()
    {
        // 为每个原TestCase的precision+scale组合，生成true/false两个onlyPositive的测试用例
        yield return new object[] { 1, 0, true, "Small values (onlyPositive = true)" };
        yield return new object[] { 1, 0, false, "Small values (onlyPositive = false)" };
        
        yield return new object[] { int.MaxValue, 0, true, "Big precision value (onlyPositive = true)" };
        yield return new object[] { int.MaxValue, 0, false, "Big precision value (onlyPositive = false)" };
        
        yield return new object[] { int.MaxValue, int.MaxValue - 1, true, "Big precision and scale values (onlyPositive = true)" };
        yield return new object[] { int.MaxValue, int.MaxValue - 1, false, "Big precision and scale values (onlyPositive = false)" };
    }

    [Theory]
    [MemberData(nameof(ValidConstructorArguments))]
    [Xunit.DisplayName("{3}")] // 使用第四个参数作为测试的显示名称
    public void Constructor_ThrowNoExceptions_OnCorrectArguments(int precision, int scale, bool onlyPositive, string testName)
    {
        Action action = () => new NumberValidator(precision, scale, onlyPositive);
        action.Should().NotThrow();
    }
}

// 假设你的NumberValidator类定义如下
public class NumberValidator
{
    public NumberValidator(int precision, int scale, bool onlyPositive)
    {
        // 构造逻辑实现
    }
}

方案优势 #

• 完全控制参数组合：MemberData让你精准定义每个测试用例的参数，避免了TestCase和Values冲突的问题。
• 保留自定义测试名称：通过DisplayName("{3}")，我们指定用数组中的第四个元素（自定义名称）作为测试显示名，既保留了原TestCase的命名风格，又能区分onlyPositive的不同取值。
• 易维护：后续添加新的precision+scale组合时，只需要在ValidConstructorArguments中补充新的条目即可。

替代方案：使用ClassData #

如果测试数据复杂或需要复用，可以把数据源抽成单独的类，实现IEnumerable<object[]>：

public class ValidConstructorArguments : IEnumerable<object[]>
{
    public IEnumerator<object[]> GetEnumerator()
    {
        yield return new object[] { 1, 0, true, "Small values (onlyPositive = true)" };
        yield return new object[] { 1, 0, false, "Small values (onlyPositive = false)" };
        // 其他组合...
    }

    System.Collections.IEnumerator System.Collections.IEnumerable.GetEnumerator() => GetEnumerator();
}

然后测试方法修改为：

[Theory]
[ClassData(typeof(ValidConstructorArguments))]
[Xunit.DisplayName("{3}")]
public void Constructor_ThrowNoExceptions_OnCorrectArguments(int precision, int scale, bool onlyPositive, string testName)
{
    // 测试逻辑不变
}

这种方式实现了测试数据与测试逻辑的分离，适合更复杂的场景。

内容的提问来源于stack exchange，提问作者Defalt