NUnit框架在WPF项目中的单元测试实战指南

老爸评测

1. 项目概述：NUnit框架在WPF项目中的实战应用

这个实战项目展示了如何在一个典型的WPF应用程序中实施全面的单元测试。项目采用NUnit 4.1.0作为测试框架，通过Calculator和StringProcessor两个核心业务类的测试案例，系统性地演示了NUnit的各项核心功能。

项目结构采用了标准的解决方案布局，将主应用程序(NUnitDemo)与测试项目(NUnitDemo.Tests)分离。这种分离式结构是.NET生态中的最佳实践，既保持了生产代码的纯净性，又确保了测试代码的独立性。测试项目中包含了四组测试类，分别演示基础测试、参数化测试、高级特性以及集合测试等不同维度的NUnit功能。

提示：虽然项目使用的是NUnit 4.1.0版本，但大部分概念和用法同样适用于NUnit 3.x系列，差异部分我会在相应章节特别说明。

2. 环境准备与项目结构解析

2.1 开发环境要求

要运行这个项目，你需要准备以下环境：

Visual Studio 2022（社区版即可）
.NET 6.0或更高版本的SDK
NuGet包管理器（通常随VS2022自动安装）

项目已经配置了必要的NuGet包引用：

主项目：仅包含WPF基础依赖
测试项目：
- NUnit (4.1.0)
- NUnit3TestAdapter (4.5.0)
- Microsoft.NET.Test.Sdk (17.6.3)

2.2 解决方案结构详解

让我们深入看一下项目结构的设计思路：

code复制NUnitDemo.sln
├── NUnitDemo/ (主应用程序)
│   ├── Calculator.cs
│   ├── StringProcessor.cs
│   ├── MainWindow.xaml
│   └── (其他WPF标准文件)
└── NUnitDemo.Tests/ (测试项目)
    ├── CalculatorTests.cs
    ├── StringProcessorTests.cs
    ├── AdvancedFeaturesTests.cs
    └── CollectionTests.cs

这种结构有以下几个优势：

职责分离：生产代码和测试代码物理隔离
引用清晰：测试项目引用主项目，反之则不行
构建灵活：可以单独构建测试项目而不影响主应用

3. 核心测试类实现解析

3.1 Calculator类及其测试

Calculator.cs实现了一个简单的四则运算器：

csharp复制public class Calculator
{
    public double Add(double a, double b) => a + b;
    public double Subtract(double a, double b) => a - b;
    public double Multiply(double a, double b) => a * b;
    public double Divide(double a, double b)
    {
        if (b == 0) throw new DivideByZeroException();
        return a / b;
    }
}

对应的CalculatorTests.cs展示了基础测试模式：

csharp复制[TestFixture]
public class CalculatorTests
{
    private Calculator _calculator;

    [SetUp]
    public void Setup()
    {
        _calculator = new Calculator();
    }

    [Test]
    public void Add_TwoNumbers_ReturnsCorrectSum()
    {
        var result = _calculator.Add(2.5, 3.5);
        Assert.That(result, Is.EqualTo(6));
    }

    [Test]
    public void Divide_ByZero_ThrowsException()
    {
        Assert.Throws<DivideByZeroException>(() => _calculator.Divide(10, 0));
    }
}

这里有几个值得注意的测试模式：

使用[SetUp]方法初始化测试上下文
采用Assert.That的新断言语法（NUnit 3.0+推荐）
异常测试的两种写法对比

3.2 StringProcessor类与参数化测试

StringProcessor.cs提供了字符串处理功能：

csharp复制public class StringProcessor
{
    public string Reverse(string input)
    {
        if (input == null) return null;
        return new string(input.Reverse().ToArray());
    }

    public bool IsPalindrome(string input)
    {
        if (string.IsNullOrEmpty(input)) return false;
        return input.SequenceEqual(input.Reverse());
    }
}

StringProcessorTests.cs展示了参数化测试的强大功能：

csharp复制[TestFixture]
public class StringProcessorTests
{
    [TestCase("hello", "olleh")]
    [TestCase("", "")]
    [TestCase(null, null)]
    public void Reverse_WithVariousInputs_ReturnsExpected(string input, string expected)
    {
        var processor = new StringProcessor();
        var result = processor.Reverse(input);
        Assert.That(result, Is.EqualTo(expected));
    }

    [TestCaseSource(nameof(PalindromeTestCases))]
    public void IsPalindrome_WithTestCases_ReturnsCorrect(string input, bool expected)
    {
        var processor = new StringProcessor();
        var result = processor.IsPalindrome(input);
        Assert.That(result, Is.EqualTo(expected));
    }

    private static readonly object[] PalindromeTestCases =
    {
        new object[] { "madam", true },
        new object[] { "racecar", true },
        new object[] { "hello", false },
        new object[] { "", false }
    };
}

参数化测试的关键优势：

减少重复测试代码
集中管理测试用例
清晰的测试报告输出

4. NUnit高级特性实战

4.1 测试分类与执行控制

AdvancedFeaturesTests.cs展示了NUnit的执行控制功能：

csharp复制[TestFixture]
[Category("Advanced")]
public class AdvancedFeaturesTests
{
    [Test]
    [MaxTime(100)] // 毫秒
    public void PerformanceTest_ShouldCompleteInTime()
    {
        // 模拟耗时操作
        Thread.Sleep(50);
    }

    [Test]
    [Ignore("暂时跳过，等待BUG修复")]
    public void BrokenTest_CurrentlyIgnored()
    {
        Assert.Fail("这个测试已知有问题");
    }

    [Test]
    [Repeat(5)]
    public void RepeatTest_ShouldPassEveryTime()
    {
        var randomValue = new Random().Next(1, 10);
        Assert.That(randomValue, Is.InRange(1, 10));
    }
}

这些特性在实际项目中的应用场景：

[Category]：用于CI/CD中的测试分组执行
[MaxTime]：性能回归测试
[Ignore]：临时跳过不稳定测试
[Repeat]：验证测试的稳定性

4.2 集合断言与约束模型

CollectionTests.cs展示了集合测试的高级技巧：

csharp复制[TestFixture]
public class CollectionTests
{
    [Test]
    public void CollectionAssert_UsageExamples()
    {
        var numbers = new[] { 1, 3, 5, 7, 9 };
        
        // 传统集合断言
        CollectionAssert.AllItemsAreUnique(numbers);
        CollectionAssert.Contains(numbers, 5);
        
        // 约束模型断言
        Assert.That(numbers, Is.All.InstanceOf<int>());
        Assert.That(numbers, Is.Ordered.Ascending);
    }

    [Test]
    public void Dictionary_ConstraintExamples()
    {
        var dict = new Dictionary<string, int>
        {
            ["one"] = 1,
            ["two"] = 2
        };

        Assert.That(dict, Contains.Key("one"));
        Assert.That(dict, Contains.Value(2));
        Assert.That(dict.Count, Is.EqualTo(2));
    }
}