C#类库使用NUnit测试时出现引用缺失错误，如何解决？

问题描述 #

我有一个待测试的ClassLibrary项目，在向解决方案中添加新的NUnit测试项目后，出现了一系列程序集、特性及引用错误。项目结构如下（注：原提问附结构截图），测试代码如下：

using NUnit.Framework;
namespace ClasslibaryTests
{
    [TestFixture]
    public class Tests
    {

        [SetUp]
        public void Setup()
        {
        }

        [Test]
        public void Add_AddsTwoNumbers_ReturnsSum()
        {
            // Act
            var result = 2;

            // Assert
            Assert.Equals(3, result);
        }
    }
}

错误原因分析 #

• NUnit核心包缺失或版本不兼容：测试项目未安装NUnit和NUnit3TestAdapter，或者包版本与项目目标框架不匹配，导致[TestFixture]、[Test]等特性无法被识别，触发程序集引用错误。
• 未引用待测试项目：测试项目需要访问ClassLibrary的代码，若未添加项目引用，后续编写测试逻辑时会出现类型找不到的错误，同时基础引用链不完整也可能引发系列编译问题。
• 断言方法使用错误：NUnit中没有Assert.Equals这个断言方法，代码里的写法不符合NUnit的API规范，直接导致编译错误。
• 目标框架版本不一致：ClassLibrary和测试项目的目标框架（如.NET Framework vs .NET Core/.NET 5+）不匹配，会引发程序集加载、兼容性错误。

修复步骤 #

1. 安装NUnit相关NuGet包
   打开测试项目的NuGet包管理器，安装以下两个包：

   • NUnit：提供测试特性和核心断言能力
   • NUnit3TestAdapter：让IDE（如Visual Studio）能够识别并运行NUnit测试
     也可以通过Package Manager Console执行命令：

   Install-Package NUnit
   Install-Package NUnit3TestAdapter
   

2. 添加待测试项目引用
   在测试项目上右键选择「添加」→「项目引用」，勾选你的ClassLibrary项目，确保测试项目能访问到待测试的代码（当前示例代码未调用，但后续编写实际测试逻辑时必须添加）。

3. 修正断言方法
   将代码中的错误断言替换为NUnit标准写法：

   // 原错误写法
   // Assert.Equals(3, result);
   // 修正后
   Assert.AreEqual(3, result);
   

   若需判断对象引用相等，可使用Assert.AreSame，数值或值类型比较用AreEqual。

4. 统一项目目标框架
   右键解决方案→「属性」→「配置属性」，检查并调整ClassLibrary和测试项目的目标框架为同一版本（例如都设置为.NET 6或.NET Framework 4.8），避免框架不兼容问题。

5. 清理重建解决方案
   执行菜单「生成」→「清理解决方案」，然后重新生成整个解决方案，确保所有引用和编译错误被彻底修复。

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