使用 NUnit 和 .NET Core 进行 C# 单元测试Unit testing C# with NUnit and .NET Core

本文介绍如何测试 .NET Core 项目。如果要测试 ASP.NET Core 项目，请参阅。

.NET Core 2.1 SDK 或更高版本。
按需选择的文本编辑器或代码编辑器。

打开 shell 窗口。创建一个名为 unit-testing-using-nunit 的目录，以保留该解决方案。在此新目录中，运行以下命令，为类库和测试项目创建新的解决方案文件：

接下来，创建 PrimeService 目录。下图显示了当前的目录和文件结构：


    unit-testing-using-nunit.sln
    /PrimeService

将 PrimeService 作为当前目录，并运行以下命令以创建源项目：

dotnet new classlib

将 Class1.cs 重命名为 PrimeService.cs。创建 PrimeService 类的失败实现：

using System;
namespace Prime.Services
{
    public class PrimeService
    {
        public bool IsPrime(int candidate)
        {
            throw new NotImplementedException("Please create a test first.");
        }
    }
}

将目录更改回 unit-testing-using-nunit 目录。运行以下命令，向解决方案添加类库项目：

dotnet sln add PrimeService/PrimeService.csproj

接下来，创建 PrimeService.Tests 目录。下图显示了它的目录结构：

dotnet new nunit

命令可创建一个将 NUnit 用作测试库的测试项目。生成的模板在 PrimeService.Tests.csproj 文件中配置测试运行程序：

<ItemGroup>
  <PackageReference Include="NUnit3TestAdapter" Version="3.15.1" />
  <PackageReference Include="Microsoft.NET.Test.Sdk" Version="16.3.0" />
</ItemGroup>

测试项目需要其他包创建和运行单元测试。在上一步中，dotnet new 已添加 Microsoft 测试 SDK、NUnit 测试框架和 NUnit 测试适配器。现在，将 PrimeService 类库作为另一个依赖项添加到项目中。使用 dotnet add reference 命令：

dotnet add reference ../PrimeService/PrimeService.csproj

可以在 GitHub 上的中看到整个文件。

下图显示了最终的解决方案布局：

/unit-testing-using-nunit
    unit-testing-using-nunit.sln
    /PrimeService
        Source Files
    /PrimeService.Tests
        Test Source Files
        PrimeService.Tests.csproj

在 unit-testing-using-nunit 目录中执行以下命令：

编写一个失败测试，使其通过，然后重复此过程。在 PrimeService.Tests 目录中，将 UnitTest1.cs 文件重命名为 PrimeService_IsPrimeShould.cs ，并将其整个内容替换为以下代码：

using NUnit.Framework;
using Prime.Services;
namespace Prime.UnitTests.Services
{
    [TestFixture]
    public class PrimeService_IsPrimeShould
    {
        [Test]
        public void IsPrime_InputIs1_ReturnFalse()
        {
            PrimeService primeService = CreatePrimeService();
            var result = primeService.IsPrime(1);
            Assert.IsFalse(result, "1 should not be prime");
        /*
        More tests
        */
        private PrimeService CreatePrimeService()
        {
             return new PrimeService();
        }
    }
}

[TestFixture] 属性表示包含单元测试的类。属性指示方法是测试方法。

测试失败。尚未创建实现。在起作用的 PrimeService 类中编写最简单的代码，使此测试通过：

public bool IsPrime(int candidate)
{
    if (candidate == 1)
    {
        return false;
    }
    throw new NotImplementedException("Please create a test first.");
}

在 unit-testing-using-nunit 目录中再次运行 dotnet test。dotnet test 命令构建 PrimeService 项目，然后构建 PrimeService.Tests 项目。构建这两个项目后，该命令将运行此单项测试。测试通过。

你已经通过了一个测试，现在可以编写更多测试。质数有其他几种简单情况：0、-1。可以添加具有 [Test] 属性的新测试，但这很快就会变得枯燥乏味。还有其他 NUnit 属性可用于编写一套类似的测试。[TestCase] 属性用于创建一套可执行相同代码但具有不同输入参数的测试。可以使用 [TestCase] 属性来指定这些输入的值。

无需创建新的测试，而是应用此属性来创建数据驱动的单个测试。数据驱动的测试方法用于测试多个小于 2（即最小质数）的值：

[TestCase(-1)]
[TestCase(0)]
[TestCase(1)]
public void IsPrime_ValuesLessThan2_ReturnFalse(int value)
{
    var result = _primeService.IsPrime(value);
    Assert.IsFalse(result, $"{value} should not be prime");

运行 dotnet test，两项测试均失败。若要使所有测试通过，可以在 PrimeService.cs 文件中更改 Main 方法开头的 if 子句：

if (candidate < 2)

通过在主库中添加更多测试、理论和代码继续循环访问。你将拥有已完成的测试版本和。

你已生成一个小型库和该库的一组单元测试。你已将解决方案结构化，使添加新包和新测试成为了正常工作流的一部分。你已将多数的时间和精力集中在解决应用程序的目标上。

使用 NUnit 进行 C# 单元测试

使用 NUnit 和 .NET Core 进行 C# 单元测试Unit testing C# with NUnit and .NET Core