# AutoFixture基础：自动产生测试资料 ## 适用于 AutoFixture是一个为.NET平台设计的测试数据自动产生工具，它的核心理念是「匿名测试」（匿名测试）。这个概念认为，大部分的测试都不应该依赖于特定的数据值，而应该关注验证模式逻辑的正确性。 ###为什么需要AutoFixture？传统资料测试准备的痛点： 1. **样板程序代码过多**：90%的程序代码都在准备好的资料中，真正的测试逻辑没有被埋没 2. **测试焦点模糊**：很难快速理解这个测试在验证什么 3. **维护困难**：当对象结构改变时，所有相关测试都需要修改 4. **数据依赖**：测试可能意外依赖于特定的数据值 5. **重复程序代码**：相同的数据准备逻辑在多个测试中重复出现 AutoFixture 可以是 **Test Data Builder Pattern 的自动化发展版**，能够自动产生复杂的测试数据，让我们专注于测试逻辑本身。 ## 安装套件或跨越命令列安装： dotnet 添加包 AutoFixture dotnet添加包AutoFixture.Xunit2 ## 基本使用方式 ### 夹具类别与 Create() `Fixture`是AutoFixture的核心类别，提供自动产生测试资料的能力：使用自动夹具； [事实] public void AutoFixture_基本使用_产生有效资料() { // 排列 var 固定装置 = 新固定装置(); // Act - 产生基本型别 var id = Fixture.Create(); // 随机正整数 var name = Fixture.Create<字符串>(); // 类似 GUID 格式的字串 var 价格 = Fixture.Create(); // 随机十进 var isActive = Fixture.Create(); // 随机布林值 var date = Fixture.Create(); // 随机日期时间 var guid = Fixture.Create(); // 新的 GUID // 断言 id.Should().BePositive(); name.Should().NotBeNullOrEmpty(); guid.Should().NotBe(Guid.Empty); } ### CreateMany() 产生集合 [事实] public void CreateMany_产生集合_应有多个元素() { var 固定装置 = 新固定装置(); // 预设产生 3 个元素 var products = Fixture.CreateMany().ToList(); // 指定数量 var moreProducts = Fixture.CreateMany(10).ToList(); 产品.Should().HaveCount(3); moreProducts.Should().HaveCount(10); } ### 复杂物品自动陈列 AutoFixture 能够自动呈现复杂的物体结构：公开课客户 { 公共 int Id { 得到;放; } 公共字符串名称{获取;放; } 公共字符串电子邮件{获取;放; } 公共地址地址{ get;放; } // 巢成品公共列表订单 { get;放; } // 集合属性 } [事实] public void 复杂物品_应完整列出所有文献() { var 固定装置 = 新固定装置(); var customer = Fixture.Create(); // 所有属性自动填入值客户.Should().NotBeNull(); customer.Id.Should().BePositive(); customer.Name.Should().NotBeNullOrEmpty(); customer.Address.Should().NotBeNull(); customer.Address.Street.Should().NotBeNullOrEmpty(); customer.Orders.Should().NotBeEmpty(); } ## Build()模式：精确控制当需要对特定属性进行控制时，使用 `Build()` 模式： [事实] public void Build模式_指定属性() { var 固定装置 = 新固定装置(); var customer = Fixture.Build() .With(x => x.Name, "测试客户") // 指定固定值 .With(x => x.Age, 25) // 指定固定值 .Without(x => x.InternalId) // 排除属性 .Create(); customer.Name.Should().Be("测试客户"); 客户.Age.Should().Be(25); customer.InternalId.Should().Be(默认); } ### OmitAutoProperties() 控制自动设置 [事实] public void OmitAutoProperties_仅设定必要属性() { var 固定装置 = 新固定装置(); var customer = Fixture.Build() .OmitAutoProperties() // 不自动设置任何属性 .With(x => x.Id, 123) // 只设置关心的属性 .With(x => x.Name, "测试客户") .Create(); 客户.Id.Should().Be(123); customer.Name.Should().Be("测试客户"); customer.Email.Should().BeNullOrEmpty(); // 保持默认值客户.Age.Should().Be(0); // 保持默认值 } ## 循环参考处理当对象包含循环引用时，AutoFixture 提供两种处理策略： ### 预设行为：ThrowingRecursionBehavior // 预设会发送例外 [事实] public void 循环参考_默认行为_发送例外() { var 固定装置 = 新固定装置(); // Category 有父属性指向自己，造成循环参考动作 act = () => Fixture.Create(); act.Should().Throw(); } ### OmitOnRecursionBehavior：忽略循环参考 [事实] public void 循环参考_使用OmitOnRecursion_成功建立() { var 固定装置 = 新固定装置(); // 删除默认的推送例外行为 Fixture.Behaviors.OfType().ToList() .ForEach(b => 固定装置.Behaviors.Remove(b)); // 忽略加入循环参考行为 Fixture.Behaviors.Add(new OmitOnRecursionBehavior()); varcategory=fixture.Create<类别>(); 类别.Should().NotBeNull(); 类别.Name.Should().NotBeNullOrEmpty(); } ### 占用主题类别建议建立基准类别来统一处理循环参考：公共抽象类 AutoFixtureTestBase { 受保护的夹具 CreateFixture() { var 固定装置 = 新固定装置(); Fixture.Behaviors.OfType().ToList() .ForEach(b => 固定装置.Behaviors.Remove(b)); Fixture.Behaviors.Add(new OmitOnRecursionBehavior()); 返回夹具； } } 公共类 CustomerServiceTests ：AutoFixtureTestBase { [事实] public void ProcessOrder_正常订单_应处理成功() { var 固定装置 = CreateFixture(); var customer = Fixture.Create(); // 逻辑测试... } } ## xUnit 整合 ### 使用夹具共享客制化公共类产品服务测试 { 私有只读夹具_fixture；公共产品服务测试（） { _fixture = 新的 Fixture(); // 共同的客制化设定 _fixture.Customize(c => c .With(x => x.Price, () => _fixture.Create<十进制>() % 10000) .With(x => x.Name, () => $"产品-{_fixture.Create()[..8]}") ）； } [事实] public void CreateProduct_使用共享Fixture_应成功建立() { var ProductData = _fixture.Create(); var service = new ProductService(); var 结果 = service.CreateProduct(productData); 结果.Should().NotBeNull(); ProductData.Price.Should().BeLessThan(10000); } } ###结合理论测试 [理论] [内联数据（客户类型.常规）] [内联数据（客户类型.Premium）] [内联数据（客户类型.VIP）] public voidCalculateDiscount_不同客户类型_应套用正确折扣(CustomerType customerType) { var 固定装置 = 新固定装置(); var customer = Fixture.Build() .With(x => x.Type, customerType) .Create(); var order = Fixture.Create(); var 计算器 = new DiscountCalculator(); var折扣=计算器.Calculate(客户,订单); 开关（客户类型） { 案例客户类型.常规：折扣.Should().Be(0); 休息; 案例客户类型.Premium：折扣.Should().BeInRange(0.05m, 0.10m); 休息; 案例客户类型.VIP：折扣.Should().BeInRange(0.15m, 0.25m); 休息; } } ## 匿名测试原则 ###核心概念测试应该关注「行为」而不是「数据」。在大多数情况下，我们并不在乎具体的数据值是什么： // ✅ 好的做法：专注于测试逻辑 [事实] public void AddCustomer_任何有效客户_应成功新增() { var 固定装置 = 新固定装置(); var customer = Fixture.Create(); var 存储库 = new CustomerRepository(); var 结果 = repository.Add(customer); 结果.Should().BeTrue(); } // ❌避免：依赖随机值的具体内容 [事实] public void BadTest_依赖随机值() { var 固定装置 = 新固定装置(); var customer = Fixture.Create(); // 错误：假设随机产生的年龄会大于18 客户.Age.Should().BeGreaterThan(18); // 可能失败 } // ✅ 正确：明确设定关键值 [事实] public void GoodTest_显式设定关键值() { var 固定装置 = 新固定装置(); var customer = Fixture.Build() .With(x => x.Age, 25) // 显式设定 .Create(); var validator = new CustomerValidator(); var isValid = validator.IsAdult(customer); isValid.Should().BeTrue(); // 稳定的结果 } ## 进化比较：Test Data Builder 与 AutoFixture ### 传统测试数据生成器（第 03 天） // 需要手动创建Builder类别（40+行）公共类订单生成器 { 私有 int _id = 1; 私人客户_customer =新客户{名称=“默认”}; 私有列表 _items = new(); public OrderBuilder WithCustomer（客户客户） { _客户=客户；返回这个； } 公共 OrderBuilder WithItems(params OrderItem[] items) { _items = items.ToList(); 返回这个； } 公共订单 Build() => 新订单 { id = _id, 客户=_客户，项目 = _项目 }; } ### AutoFixture 方式（第 10 天） // 零设定成本，专注于测试逻辑(5行) var 固定装置 = 新固定装置(); var order = Fixture.Build() .With(x => x.Status, OrderStatus.Completed) .Create(); ###比较摘要层面 |测试数据生成器 |汽车夹具 ---|---|--- 计划码行数 | 40+ 行 Builder + 测试 | 5行测试维护成本 | 物品改变需更新自动适应变化开发时间 | 先写Builder 再写测试| 直接写测试大量资料| 需要回圈 | `创建许多(100)` 绝对性 | 业务语意明确 | 需理解汽车夹具 ## 实务应用场景 AutoFixture在实务中常用于实体测试（搭配理论验证不同输入场景）、DTO验证（使用`Build()`符合产生验证规则的数据）、以及大量数据测试（使用`CreateMany()`产生批量数据）。 > 📖 完整程序代码请参阅 [references/practical-scenarios.md]() ## 最佳实践 ### 应该做 1. **使用匿名测试概念** \- 专注于测试逻辑具体数据 2. **仅在必要时固定特定值** \- 使用 `Build().With()` 设置关键属性 3. **建立份额类别** \- 统一处理循环参考等共同配置 4. **合理的集合大小** \- 根据测试目的调整 `CreateMany()` 数量 ### 应该避免 1. **过度依赖随机值** \-不要假设随机值的具体内容 2. **忽略边界值** \- 仍然明确需要测试边界情况 3. **骗局自动产生** \- 简单测试可能用固定值更清晰 ## 混合策略建议结合两种方式的优点：公共静态类 TestDataFactory { 私有静态只读夹具_fixture = new(); // 使用AutoFixture建立基础数据，再用Builder处理公共静态 OrderBuilder AnOrder() { var baseOrder = _fixture.Create(); 返回新的 OrderBuilder(baseOrder); } // 大量随机资料产生公共静态 IEnumerable<用户> CreateRandomUsers(int count) { return _fixture.CreateMany<用户>(count); } } ## 课程代码范本请参考[templates]()资料夹中的示例文件： * [basic-autofixture-usage.cs]() \- 基本 AutoFixture 使用方式 * [complex-object-scenarios.cs]() \- 复杂对象与循环参考处理 * [xunit-integration.cs]() \- xUnit 集成与理论测试 ## 参考资源 ### 原始文章本技能内容提炼自「老派软体工程师的测试修练 - 30天挑战」系列文章： * **Day 10 - AutoFixture 基础：自动产生测试资料** * 铁人赛文章： * 示例程序代码： ### 官方文件 * [AutoFixture GitHub]() * [AutoFixture官方网站]() * [AutoFixture快速入门]() * [AutoFixture NuGet]()

Dotnet 测试自动夹具基础知识

包含技能