xUnit单元测试核心三步:建项目、写方法、运行验证;它轻量且约定优于配置,无需属性标记,靠方法名和结构识别测试。

在 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);
}
[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—— 验证异常抛出(() => method()) - 集合断言:
Assert.Contains(item, collection)、Assert.Empty(list)
若需共享上下文(如数据库连接、Mock 对象),可用 IClassFixture 实现“每个测试类一次初始化”,比构造函数更可控。
基本上就这些。xUnit 上手快,重点在于写清楚“给什么输入、期望什么输出”,而不是折腾框架本身。不复杂但容易忽略的是:测试方法名尽量表达意图(比如 Divide_ByZero_ThrowsDivideByZeroException),这比注释还管用。










