C#怎么进行单元测试 xUnit单元测试框架使用方法

来源:这里教程网 时间:2026-02-21 17:40:10 作者:

在 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
),这比注释还管用。

相关推荐