在 C# 中用 xUnit 做单元测试,核心就三步:建测试项目、写测试方法、运行验证。它比 MSTest 更轻量、更强调“约定优于配置”,不依赖属性标记(如
[TestMethod]),而是靠方法名和结构自动识别测试。
1. 创建 xUnit 测试项目
推荐用 .NET CLI 或 Visual Studio 创建标准 xUnit 项目,它会自动引用
xunit、
xunit.runner.visualstudio和
Microsoft.NET.Test.Sdk: 命令行创建:
dotnet new xunit -n MyProject.Tests添加对被测项目的引用:
dotnet add reference ../MyProject/MyProject.csproj确保目标框架一致(如都用
net8.0),避免运行时报错
2. 编写基础测试方法
xUnit 使用
[Fact]标记无参的普通测试,用
[Theory]+
[InlineData]做数据驱动测试。方法必须是 public、无返回值、无参数(Fact)或参数与 InlineData 匹配(Theory):
public class CalculatorTests
{
[Fact]
public void Add_ReturnsCorrectResult()
{
var calc = new Calculator();
var result = calc.Add(2, 3);
Assert.Equal(5, result);
}
<pre class="brush:php;toolbar:false;">[Theory]
[InlineData(1, 1, 2)]
[InlineData(0, 5, 5)]
[InlineData(-2, 2, 0)]
public void Add_HandlesMultipleInputs(int a, int b, int expected)
{
var calc = new Calculator();
Assert.Equal(expected, calc.Add(a, b));
}}
注意:xUnit 不支持
[TestInitialize]/
[TestCleanup],改用构造函数和
IDisposable实现“每测试实例”级清理(不是每个方法前/后)。
3. 运行与调试测试
无需额外安装插件,在终端或 VS 中都能直接运行:
终端运行全部测试:dotnet test运行指定测试类:
dotnet test --filter "FullyQualifiedName~CalculatorTests"Visual Studio 中,测试资源管理器(Test Explorer)会自动发现测试,点击“运行”即可 断点调试测试方法,和调试业务代码完全一样
4. 常用断言与进阶技巧
xUnit 的
Assert类简洁直接,常用方法有:
Assert.Equal(expected, actual)—— 推荐用于值类型、字符串、简单对象(会深度比较)
Assert.True(condition)/
Assert.False(condition)
Assert.Throws<argumentexception>(() => method())</argumentexception>—— 验证异常抛出 集合断言:
Assert.Contains(item, collection)、
Assert.Empty(list)
若需共享上下文(如数据库连接、Mock 对象),可用
IClassFixture<t></t>实现“每个测试类一次初始化”,比构造函数更可控。
基本上就这些。xUnit 上手快,重点在于写清楚“给什么输入、期望什么输出”,而不是折腾框架本身。不复杂但容易忽略的是:测试方法名尽量表达意图(比如
Divide_ByZero_ThrowsDivideByZeroException),这比注释还管用。
