NUnit 项目使用教程

1. 项目介绍

NUnit 是一个为所有 .NET 语言设计的单元测试框架。它最初是从 JUnit 移植过来的，当前的生产版本（版本 3）已经完全重写，支持广泛的 .NET 平台。NUnit 可以在 macOS、Linux 和 Windows 操作系统上运行，适用于从使用 TDD 的单元测试到全面的系统和集成测试。

NUnit 是一个非主观的、广泛而深入的框架，提供了多种不同的方式来断言代码的行为符合预期。许多方面可以扩展以适应特定的需求。最新版本（版本 4）是对开创性的 NUnit 3 框架的升级，旨在利用最新的 .NET 特性和 C# 语言构造。

2. 项目快速启动

2.1 安装 NUnit

首先，确保你已经安装了 .NET SDK。然后，你可以通过 NuGet 安装 NUnit：

dotnet new console -n MyTestProject
cd MyTestProject
dotnet add package NUnit
dotnet add package NUnit.ConsoleRunner

2.2 创建测试项目

在项目目录中创建一个新的测试项目：

dotnet new nunit -n MyTestProject.Tests
cd MyTestProject.Tests
dotnet add reference ../MyTestProject/MyTestProject.csproj

2.3 编写第一个测试

在 MyTestProject.Tests 目录中，创建一个名为 UnitTest1.cs 的文件，并编写以下代码：

using NUnit.Framework;
using MyTestProject;

namespace MyTestProject.Tests
{
    [TestFixture]
    public class MyTestClass
    {
        [Test]
        public void MyFirstTest()
        {
            Assert.AreEqual(4, 2 + 2);
        }
    }
}

2.4 运行测试

在 MyTestProject.Tests 目录中运行以下命令来执行测试：

dotnet test

3. 应用案例和最佳实践

3.1 单元测试

NUnit 最常见的用途是进行单元测试。以下是一个简单的单元测试示例：

[TestFixture]
public class CalculatorTests
{
    private Calculator _calculator;

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

    [Test]
    public void Add_TwoNumbers_ReturnsSum()
    {
        var result = _calculator.Add(1, 2);
        Assert.AreEqual(3, result);
    }
}

3.2 数据驱动测试

使用 [TestCase] 属性可以创建数据驱动的测试：

[TestFixture]
public class DataDrivenTests
{
    [TestCase(1, 2, 3)]
    [TestCase(0, 0, 0)]
    [TestCase(-1, 1, 0)]
    public void Add_TwoNumbers_ReturnsSum(int a, int b, int expected)
    {
        var calculator = new Calculator();
        var result = calculator.Add(a, b);
        Assert.AreEqual(expected, result);
    }
}

4. 典型生态项目

4.1 NUnit Console and Engine

NUnit Console 是一个命令行工具，用于运行 NUnit 测试。NUnit Engine 是 NUnit 的核心，用于在不同的测试运行器中运行 NUnit 测试。

4.2 NUnit Visual Studio Adapter

NUnit Visual Studio Adapter 是一个 Visual Studio 扩展，允许在 Visual Studio 中运行 NUnit 测试。

4.3 NUnit 3 Test Adapter

NUnit 3 Test Adapter 是一个 Visual Studio 扩展，允许在 Visual Studio 中运行 NUnit 3 测试。

通过这些工具和扩展，NUnit 提供了一个完整的测试生态系统，帮助开发者轻松地进行单元测试和集成测试。