csharp-tunit

TUnit 最佳实践

您的目标是帮助我使用 TUnit 编写有效的单元测试，涵盖标准测试和数据驱动测试方法。

项目设置

• 使用单独的测试项目，命名约定为 [ProjectName].Tests
• 引用 TUnit 包和 TUnit.Assertions 以使用流畅断言
• 创建与待测试类匹配的测试类（例如，为 Calculator 创建 CalculatorTests）
• 使用 .NET SDK 测试命令：dotnet test 运行测试
• TUnit 需要 .NET 8.0 或更高版本

测试结构

• 不需要测试类属性（如 xUnit/NUnit）
• 测试方法使用 [Test] 属性（而不是 xUnit 的 [Fact]）
• 遵循 Arrange-Act-Assert (AAA) 模式
• 使用 MethodName_Scenario_ExpectedBehavior 模式命名测试
• 使用生命周期钩子：[Before(Test)] 用于设置，[After(Test)] 用于清理
• 使用 [Before(Class)] 和 [After(Class)] 在类中的测试之间共享上下文
• 使用 [Before(Assembly)] 和 [After(Assembly)] 跨测试类共享上下文
• TUnit 支持高级生命周期钩子，如 [Before(TestSession)] 和 [After(TestSession)]

标准测试

• 保持测试专注于单一行为
• 避免在一个测试方法中测试多个行为
• 使用 TUnit 的流畅断言语法 await Assert.That()
• 仅包含验证测试用例所需的断言
• 使测试独立且幂等（可以按任意顺序运行）
• 避免测试相互依赖（如果需要，使用 [DependsOn] 属性）

数据驱动测试

• 使用 [Arguments] 属性提供内联测试数据（相当于 xUnit 的 [InlineData]）
• 使用 [MethodData] 提供基于方法的测试数据（相当于 xUnit 的 [MemberData]）
• 使用 [ClassData] 提供基于类的测试数据
• 通过实现 ITestDataSource 创建自定义数据源
• 在数据驱动测试中使用有意义的参数名
• 同一个测试方法可以应用多个 [Arguments] 属性

断言

• 使用 await Assert.That(value).IsEqualTo(expected) 进行值相等性比较
• 使用 await Assert.That(value).IsSameReferenceAs(expected) 进行引用相等性比较
• 使用 await Assert.That(value).IsTrue() 或 await Assert.That(value).IsFalse() 进行布尔条件判断
• 使用 await Assert.That(collection).Contains(item) 或 await Assert.That(collection).DoesNotContain(item) 进行集合操作
• 使用 await Assert.That(value).Matches(pattern) 进行正则表达式模式匹配
• 使用 await Assert.That(action).Throws<TException>() 或 await Assert.That(asyncAction).ThrowsAsync<TException>() 测试异常
• 使用 .And 运算符链式断言：await Assert.That(value).IsNotNull().And.IsEqualTo(expected)
• 使用 .Or 运算符处理替代条件：await Assert.That(value).IsEqualTo(1).Or.IsEqualTo(2)
• 使用 .Within(tolerance) 进行 DateTime 和数值比较（带容差）
• 所有断言都是异步的，必须等待

高级功能

• 使用 [Repeat(n)] 重复运行测试多次
• 使用 [Retry(n)] 在失败时自动重试
• 使用 [ParallelLimit<T>] 控制并行执行限制
• 使用 [Skip("reason")] 有条件地跳过测试
• 使用 [DependsOn(nameof(OtherTest))] 创建测试依赖
• 使用 [Timeout(milliseconds)] 设置测试超时
• 通过扩展 TUnit 的基础属性创建自定义属性

测试组织

• 按功能或组件分组测试
• 使用 [Category("CategoryName")] 进行测试分类
• 使用 [DisplayName("Custom Test Name")] 自定义测试名称
• 考虑使用 TestContext 进行测试诊断和信息获取
• 使用条件属性，如自定义 [WindowsOnly] 用于平台特定测试

性能和并行执行

• TUnit 默认并行运行测试（与 xUnit 不同，xUnit 需要显式配置）
• 使用 [NotInParallel] 禁用特定测试的并行执行
• 使用 [ParallelLimit<T>] 配合自定义限制类控制并发
• 同一类中的测试默认按顺序执行
• 使用 [Repeat(n)] 配合 [ParallelLimit<T>] 进行负载测试场景

从 xUnit 迁移

• 将 [Fact] 替换为 [Test]
• 将 [Theory] 替换为 [Test]，并使用 [Arguments] 提供数据
• 将 [InlineData] 替换为 [Arguments]
• 将 [MemberData] 替换为 [MethodData]
• 将 Assert.Equal 替换为 await Assert.That(actual).IsEqualTo(expected)
• 将 Assert.True 替换为 await Assert.That(condition).IsTrue()
• 将 Assert.Throws<T> 替换为 await Assert.That(action).Throws<T>()
• 将构造函数/IDisposable 替换为 [Before(Test)]/[After(Test)]
• 将 IClassFixture<T> 替换为 [Before(Class)]/[After(Class)]

为什么选择 TUnit 而不是 xUnit？

TUnit 提供了现代、快速且灵活的测试体验，具有 xUnit 所不具备的高级功能，例如异步断言、更精细的生命周期钩子和改进的数据驱动测试能力。TUnit 的流畅断言提供了更清晰、更具表现力的测试验证，使其特别适合复杂的 .NET 项目。