如何高效构建集合元素单元测试：避免重复且独立展示用例

我需要测试两个日期范围是否重叠的逻辑，已经准备了36个包含预期结果的测试用例，但当前写法是把所有用例塞在一个测试方法里执行。我希望每个测试用例能作为独立测试项展示，又不想编写36个几乎完全相同的测试方法，求对应的最佳实践。

当前测试代码如下：

[TestClass]
public class DateTimeRangeTests
{
    [TestMethod]
    public void TestDateOverlaps()
    {
        DateTime periodFrom = new DateTime(2022, 02, 01);
        DateTime periodTo = new DateTime(2022, 05, 01);

        var rangedItems = new List<RangedItemTestRow>()
        {
            new RangedItemTestRow(){ Id = 1, Start = new DateTime(2022, 01, 01), End =  new DateTime(2022, 01, 15), ExpectedOverlap = false},
            new RangedItemTestRow(){ Id = 2, Start = new DateTime(2022, 02, 01), End =  new DateTime(2022, 01, 15), ExpectedOverlap = false},
            new RangedItemTestRow(){ Id = 3, Start = new DateTime(2022, 02, 02), End =  new DateTime(2022, 01, 15), ExpectedOverlap = false},
            // 剩余33个测试用例...
        };

        List<RangedItemTestRow> overlappingItems = rangedItems
            .Where(x =>
                    (x.Start >= periodFrom && x.Start <= periodTo) ||
                    (x.End == periodFrom) ||
                    (x.End >= periodFrom && x.End <= periodTo) ||
                    (x.Start <= periodFrom && x.End >= periodTo)
            )
            .ToList();

        foreach (RangedItemTestRow item in rangedItems)
        {
            bool inOverlapped = overlappingItems.Any(x => x.Id == item.Id);
            Assert.AreEqual(item.ExpectedOverlap, inOverlapped, $"Id: {item.Id} | {item.Start} => {item.End} | Expected: {item.ExpectedOverlap} | Was: {inOverlapped}");
        }
    }
}

public class RangedItemTestRow
{
    public int Id { get; set; }
    public DateTime Start { get; set; }
    public DateTime End { get; set; }
    public bool ExpectedOverlap { get; set; }
}

解决方案：参数化测试 #

针对你当前使用的MSTest框架，有两种主流方案实现“一个测试用例对应一个独立测试项”的需求：

1. 使用DataRow特性（MSTest v2+） #

直接给测试方法添加[DataRow]特性，每个特性对应一个测试用例，测试运行器会将每个DataRow当作独立测试项执行。

示例代码：

[TestClass]
public class DateTimeRangeTests
{
    private readonly DateTime _periodFrom = new DateTime(2022, 02, 01);
    private readonly DateTime _periodTo = new DateTime(2022, 05, 01);

    [DataRow(1, 2022, 1, 1, 2022, 1, 15, false)]
    [DataRow(2, 2022, 2, 1, 2022, 1, 15, false)]
    [DataRow(3, 2022, 2, 2, 2022, 1, 15, false)]
    // 依次添加剩余33个DataRow...
    [TestMethod]
    public void TestDateOverlap(int id, int startYear, int startMonth, int startDay, int endYear, int endMonth, int endDay, bool expectedOverlap)
    {
        DateTime testStart = new DateTime(startYear, startMonth, startDay);
        DateTime testEnd = new DateTime(endYear, endMonth, endDay);

        bool actualOverlap = IsRangeOverlapping(testStart, testEnd);
        Assert.AreEqual(expectedOverlap, actualOverlap, $"Id: {id} | {testStart:yyyy-MM-dd} => {testEnd:yyyy-MM-dd}");
    }

    // 抽离重叠判断逻辑，提升复用性和可读性
    private bool IsRangeOverlapping(DateTime testStart, DateTime testEnd)
    {
        return (testStart >= _periodFrom && testStart <= _periodTo) ||
               (testEnd == _periodFrom) ||
               (testEnd >= _periodFrom && testEnd <= _periodTo) ||
               (testStart <= _periodFrom && testEnd >= _periodTo);
    }
}

优点：

• 每个测试用例独立展示，失败时直接定位到具体用例
• 代码简洁，无需额外依赖外部文件

2. 使用DataSource特性（适合大量测试用例） #

如果36个用例全部写DataRow过于繁琐，可以将测试数据放在外部文件（如CSV、XML）中，通过[DataSource]特性读取数据，实现数据与代码分离。

示例代码：

[TestClass]
public class DateTimeRangeTests
{
    private readonly DateTime _periodFrom = new DateTime(2022, 02, 01);
    private readonly DateTime _periodTo = new DateTime(2022, 05, 01);
    private TestContext _testContext;

    // 必须实现TestContext属性，用于读取数据源数据
    public TestContext TestContext
    {
        get => _testContext;
        set => _testContext = value;
    }

    [DataSource("Microsoft.VisualStudio.TestTools.DataSource.CSV", "DateRangeTestData.csv", "DateRangeTestData#csv", DataAccessMethod.Sequential)]
    [TestMethod]
    public void TestDateOverlapFromCsv()
    {
        int id = int.Parse(TestContext.DataRow["Id"].ToString());
        DateTime testStart = DateTime.Parse(TestContext.DataRow["Start"].ToString());
        DateTime testEnd = DateTime.Parse(TestContext.DataRow["End"].ToString());
        bool expectedOverlap = bool.Parse(TestContext.DataRow["ExpectedOverlap"].ToString());

        bool actualOverlap = IsRangeOverlapping(testStart, testEnd);
        Assert.AreEqual(expectedOverlap, actualOverlap, $"Id: {id} | {testStart:yyyy-MM-dd} => {testEnd:yyyy-MM-dd}");
    }

    private bool IsRangeOverlapping(DateTime testStart, DateTime testEnd)
    {
        // 同之前的重叠判断逻辑
        return (testStart >= _periodFrom && testStart <= _periodTo) ||
               (testEnd == _periodFrom) ||
               (testEnd >= _periodFrom && testEnd <= _periodTo) ||
               (testStart <= _periodFrom && testEnd >= _periodTo);
    }
}

对应的CSV文件DateRangeTestData.csv内容示例：

Id,Start,End,ExpectedOverlap
1,2022-01-01,2022-01-15,false
2,2022-02-01,2022-01-15,false
3,2022-02-02,2022-01-15,false
// 剩余33行测试数据...

优点：

• 数据与代码分离，修改测试用例无需改动代码
• 适合维护大量测试用例，扩展性更好

补充：其他测试框架的方案 #

如果你后续切换到xUnit或NUnit，也有对应的参数化测试方案：

• xUnit：使用[Theory] + [InlineData]/[MemberData]
• NUnit：使用[Test] + [TestCase]
  核心逻辑一致，都是通过参数化让每个测试用例独立运行。

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