NSubstitute：.NET单元测试中的友好模拟框架指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00915/article/details/148758316

NSubstitute：.NET单元测试中的友好模拟框架指南

NSubstitute A friendly substitute for .NET mocking libraries. 项目地址: https://gitcode.com/gh_mirrors/ns/NSubstitute

什么是NSubstitute？

NSubstitute是一个专为.NET开发者设计的模拟框架（Mocking Framework），它以简洁优雅的语法和直观的操作方式著称。相比其他复杂的模拟库，NSubstitute提供了更加人性化的API，让开发者能够专注于测试逻辑本身，而不是框架的使用细节。

核心特性解析

1. 极简API设计

NSubstitute的API设计遵循"约定优于配置"原则，最常见的操作只需一行代码：

// 创建接口模拟
var calculator = Substitute.For<ICalculator>();

// 设置返回值
calculator.Add(1, 2).Returns(3);

// 验证调用
calculator.Received().Add(1, Arg.Any<int>());

这种流畅接口(Fluent Interface)设计使得测试代码几乎可以自解释，大大提升了测试代码的可读性。

2. 智能异常提示

当测试失败时，NSubstitute会提供极其详细的错误信息，帮助开发者快速定位问题：

ReceivedCallsException : Expected to receive a call matching:
    Add(1, 2)
Actually received no matching calls.
Received 2 non-matching calls (non-matching arguments indicated with '*' characters):
    Add(*4*, *7*)
    Add(1, *5*)

这种错误信息不仅告诉你期望什么调用，还列出了实际收到的所有调用，并用星号(*)标记出不匹配的参数，调试效率大幅提升。

3. 灵活的测试策略

NSubstitute不强制你区分Mock、Stub、Fake等测试替身(Test Double)类型，它提供统一的"Substitute"概念：

可以配置方法返回值（Stub行为）
可以验证方法调用（Mock行为）
可以触发事件
支持参数匹配器

这种设计让开发者不必纠结于测试替身的类型选择，只需关注测试本身的需求。

典型使用场景

基本模拟与验证

// 创建模拟对象
var orderService = Substitute.For<IOrderService>();

// 设置方法行为
orderService.PlaceOrder(Arg.Any<Order>()).Returns(true);

// 执行测试
var result = orderService.PlaceOrder(new Order());

// 验证交互
orderService.Received(1).PlaceOrder(Arg.Any<Order>());

事件测试

var monitor = Substitute.For<IMonitor>();
bool eventTriggered = false;

monitor.TemperatureChanged += (sender, args) => eventTriggered = true;

// 触发事件
monitor.TemperatureChanged += Raise.Event();

Assert.True(eventTriggered);

参数匹配

NSubstitute提供多种参数匹配方式：

// 任意参数
calculator.Add(Arg.Any<int>(), 5).Returns(10);

// 特定类型参数
calculator.Add(Arg.Is<int>(x => x > 10), Arg.Any<int>()).Returns(20);

// 复杂对象匹配
userService.FindUser(Arg.Is<User>(u => u.Age > 18)).Returns(new User());