在C#项目开发中，编写单元测试可以有效验证代码逻辑的正确性，减少后期调试成本，NUnit作为成熟的单元测试框架，提供了丰富的测试功能和简洁的语法，适合各类C#项目的测试需求。
NUnit环境准备
首先需要在项目中引入NUnit相关的依赖包，如果你使用的是Visual Studio开发，可以通过NuGet包管理器安装以下两个包：
- NUnit：核心测试框架包，提供测试注解、断言等基础功能
- NUnit3TestAdapter：测试适配器，让Visual Studio能够识别并运行NUnit测试用例
安装完成后，就可以开始编写测试代码了。
核心测试注解说明
NUnit通过注解来标记测试相关的类和方法，常用的注解如下：
| 注解名称 | 作用说明 |
|---|---|
| test_fixture | 标记一个类为测试类，NUnit会扫描该类中标记了测试注解的方法 |
| test | 标记一个方法为测试方法，该方法会被NUnit执行 |
| set_up | 标记的方法会在每个测试方法执行前运行，用于初始化测试数据 |
| tear_down | 标记的方法会在每个测试方法执行后运行，用于清理测试资源 |
| one_time_set_up | 标记的方法会在整个测试类执行前运行一次，用于初始化全局资源 |
| one_time_tear_down | 标记的方法会在整个测试类执行后运行一次，用于清理全局资源 |
编写第一个NUnit测试用例
我们先创建一个待测试的业务类，假设这个类包含简单的数学运算方法：
// 待测试的业务类
public class Calculator
{
// 加法方法
public int Add(int a, int b)
{
return a + b;
}
// 减法方法
public int Subtract(int a, int b)
{
return a - b;
}
}
接下来编写对应的NUnit测试类，测试上述Calculator类的功能：
using NUnit.Framework;
// 标记该类为测试类
[TestFixture]
public class CalculatorTests
{
private Calculator _calculator;
// 每个测试方法执行前初始化Calculator实例
[SetUp]
public void Setup()
{
_calculator = new Calculator();
}
// 测试加法方法
[Test]
public void Add_传入两个正整数_返回正确和()
{
// 调用待测试方法
int result = _calculator.Add(2, 3);
// 断言结果是否符合预期
Assert.AreEqual(5, result);
}
// 测试减法方法
[Test]
public void Subtract_传入被减数和减数_返回正确差()
{
int result = _calculator.Subtract(10, 4);
Assert.AreEqual(6, result);
}
}
编写完成后，在Visual Studio的测试资源管理器中就可以看到这两个测试用例，点击运行即可执行测试，查看测试结果。
常用断言方法
NUnit的Assert类提供了多种断言方法，用于验证测试结果是否符合预期，常用的断言如下：
Assert.AreEqual(expected, actual)：验证实际值等于预期值Assert.AreNotEqual(notExpected, actual)：验证实际值不等于预期值Assert.IsTrue(condition)：验证条件为trueAssert.IsFalse(condition)：验证条件为falseAssert.IsNull(obj)：验证对象为nullAssert.IsNotNull(obj)：验证对象不为nullAssert.Throws<TException>(() => 方法调用)：验证方法调用会抛出指定类型的异常
异常测试示例
假设我们的业务类有一个除法方法，当除数为0时会抛出DivideByZeroException异常，测试代码如下：
public class Calculator
{
// 其他方法...
// 除法方法
public int Divide(int a, int b)
{
if (b == 0)
{
throw new DivideByZeroException("除数不能为0");
}
return a / b;
}
}
[TestFixture]
public class CalculatorTests
{
private Calculator _calculator;
[SetUp]
public void Setup()
{
_calculator = new Calculator();
}
// 测试除数为0的场景
[Test]
public void Divide_除数为0_抛出DivideByZeroException()
{
// 验证调用Divide(10,0)会抛出DivideByZeroException异常
Assert.Throws<DivideByZeroException>(() => _calculator.Divide(10, 0));
}
}
参数化测试
如果同一个测试方法需要验证多组不同的输入参数，可以使用参数化测试，避免编写重复的测试代码。NUnit提供了TestCase注解来实现参数化测试：
[TestFixture]
public class CalculatorTests
{
private Calculator _calculator;
[SetUp]
public void Setup()
{
_calculator = new Calculator();
}
// 参数化测试加法方法，传入多组参数
[Test]
[TestCase(1, 2, 3)]
[TestCase(0, 0, 0)]
[TestCase(-1, 5, 4)]
[TestCase(100, 200, 300)]
public void Add_多组参数_返回正确结果(int a, int b, int expected)
{
int result = _calculator.Add(a, b);
Assert.AreEqual(expected, result);
}
}
上述测试方法会被执行4次，分别使用TestCase中标注的4组参数，大幅减少了重复代码的编写。
测试套件组织
当测试用例数量较多时，可以通过TestFixture和TestSuite来组织测试套件，NUnit会自动识别所有标记了TestFixture的类，也可以手动指定要运行的测试类。在大型项目中，建议按照业务模块划分测试类，每个业务类对应一个测试类，方便管理和维护。
编写单元测试时，测试方法的命名建议采用 被测试方法_测试场景_预期结果 的格式，这样即使不看测试内容，也能快速知道该测试用例的验证目标。
C#NUnit单元测试test_fixture修改时间：2026-07-20 13:09:37