一款开源、强大、简单易用的 .NET 假数据生成利器

前言

在日常的 .NET 项目开发中，我们经常需要大量的测试数据来验证业务逻辑、填充数据库、进行性能测试或者做产品演示。手动编写这些测试数据不仅枯燥乏味、浪费时间，而且难以覆盖各种边界场景。今天大姚给大家推荐一款开源、强大、简单易用的 .NET 假数据生成库：Bogus。
项目介绍

Bogus 是一个基于著名的 faker.js 移植而来的开源（MIT License） .NET 假数据生成库，它为 .NET 开发者提供了一套强大、简单易用的 API，可快速生成各种类型的模拟数据，支持 40+ 种语言区域本地化，广泛应用于单元测试、数据库填充、原型演示以及示例数据生成等场景。
支持语言

支持语言：C#、F#、VB.NET。
应用场景

• 单元测试 / 集成测试：快速生成符合业务模型的测试对象，替代手工 Mock 数据。
  
• 数据库填充（Seed）：开发/测试环境数据库填充真实感十足的假数据。
  
• 性能与压力测试：批量生成大规模数据集来模拟真实负载。
  
• API 开发调试：快速构造 API 返回的模拟响应数据。
  
• 数据脱敏：替换生产数据中的敏感信息。
  

支持以下语言环境

Bogus 支持以下语言环境：

创建一个 .NET 控制台应用

接下来我们创建一个名为：BogusExercise .NET 9 控制台应用：

项目 NuGet 安装

在 NuGet 包管理器控制台中执行：

1. Install-Package Bogus

复制代码

或者在 NuGet 包管理器中搜索安装：

Bogus 快速入门

生成 3 个随机订单的模拟用户信息

以下是 Bogus 仓库中提供的示例代码，使用 Bogus 生成了 3 个带随机订单的模拟用户。

1.     public classProgram
2.     {
3.         static void Main(string[] args)
4.         {
5.             //生成 3 个随机订单的模拟用户信息
6.             var users = GenerateSampleUsers(3);
7.         }
9.         /// 
10.         /// 生成随机订单的模拟用户
11.         /// 
12.         /// 
13.         /// 
14.         public static List GenerateSampleUsers(int count = 3)
15.         {
16.             // 设置随机种子，生成可重复的数据集
17.             Randomizer.Seed = new Random(3897234);
19.             var fruit = new[] { "apple", "banana", "orange", "strawberry", "kiwi" };
21.             var orderIds = 0;
22.             var testOrders = new Faker()
23.                 // 开启严格模式：确保所有属性都有规则
24.                 .StrictMode(true)
25.                 // OrderId 自增
26.                 .RuleFor(o => o.OrderId, f => orderIds++)
27.                 // 从水果篮中随机挑选
28.                 .RuleFor(o => o.Item, f => f.PickRandom(fruit))
29.                 // 随机数量 1~10
30.                 .RuleFor(o => o.Quantity, f => f.Random.Number(1, 10))
31.                 // 可空 int?，80% 概率为 null
32.                 .RuleFor(o => o.LotNumber, f => f.Random.Int(0, 100).OrNull(f, .8f));
34.             var userIds = 0;
35.             var testUsers = new Faker()
36.                 // 自定义构造函数
37.                 .CustomInstantiator(f => new User(userIds++, f.Random.Replace("###-##-####")))
38.                 // 基本规则
39.                 .RuleFor(u => u.FirstName, f => f.Name.FirstName())
40.                 .RuleFor(u => u.LastName, f => f.Name.LastName())
41.                 .RuleFor(u => u.Avatar, f => f.Internet.Avatar())
42.                 .RuleFor(u => u.UserName, (f, u) => f.Internet.UserName(u.FirstName, u.LastName))
43.                 .RuleFor(u => u.Email, (f, u) => f.Internet.Email(u.FirstName, u.LastName))
44.                 .RuleFor(u => u.SomethingUnique, f => $"Value {f.UniqueIndex}")
45.                 .RuleFor(u => u.SomeGuid, Guid.NewGuid)
46.                 // 随机选取枚举
47.                 .RuleFor(u => u.Gender, f => f.PickRandom())
48.                 .RuleFor(u => u.CartId, f => Guid.NewGuid())
49.                 // 组合属性：利用已生成的 FirstName 和 LastName
50.                 .RuleFor(u => u.FullName, (f, u) => u.FirstName + " " + u.LastName)
51.                 // 嵌套集合生成
52.                 .RuleFor(u => u.Orders, f => testOrders.Generate(3))
53.                 // 生成完成后的回调
54.                 .FinishWith((f, u) =>
55.                 {
56.                     Console.WriteLine("User Created! Name={0}", u.FullName);
57.                 });
59.             // 一次生成 3 个用户
60.             return testUsers.Generate(count);
61.         }
62.     }
64.     /// 
65.     /// 订单实体
66.     /// 
67.     publicclassOrder
68.     {
69.         publicint OrderId { get; set; }
70.         publicstring Item { get; set; }
71.         publicint Quantity { get; set; }
72.         publicint? LotNumber { get; set; }
73.     }
75.     /// 
76.     /// 性别枚举
77.     /// 
78.     publicenum Gender
79.     {
80.         Male,
81.         Female
82.     }
84.     /// 
85.     /// 用户实体
86.     /// 
87.     publicclassUser
88.     {
89.         public User(int userId, string ssn)
90.         {
91.             this.Id = userId;
92.             this.SSN = ssn;
93.         }
95.         publicint Id { get; set; }
96.         publicstring FirstName { get; set; }
97.         publicstring LastName { get; set; }
98.         publicstring FullName { get; set; }
99.         publicstring UserName { get; set; }
100.         publicstring Email { get; set; }
101.         publicstring SomethingUnique { get; set; }
102.         public Guid SomeGuid { get; set; }
103.         publicstring Avatar { get; set; }
104.         public Guid CartId { get; set; }
105.         publicstring SSN { get; set; }
106.         public Gender Gender { get; set; }
107.         public List Orders { get; set; }
108.     }

复制代码

生成随机用户信息

使用 Bogus 快速生成随机用户姓名、邮箱、地址、电话等关联数据：

1.         /// 
2.         /// 生成随机用户信息
3.         /// 
4.         public static void GenerateRandomData()
5.         {
6.             // 自动生成姓名、邮箱、地址、电话等关联数据
7.             var faker = new Faker("zh_CN");// 使用简体中文
8.             var randomName = faker.Name.FullName();
9.             var randomEmail = faker.Internet.Email();
10.             var randomAddress = faker.Address.FullAddress();
11.             var randomPhone = faker.Phone.PhoneNumber();
12.             Console.WriteLine($"Name: {randomName}");
13.             Console.WriteLine($"Email: {randomEmail}");
14.             Console.WriteLine($"Address: {randomAddress}");
15.             Console.WriteLine($"Phone: {randomPhone}");
16.         }

复制代码

EF Core 数据库种子数据填充

使用 EF Core 填充 Blog & Post 数据：

1.     /// 
2.     /// EF Core 数据库种子数据填充
3.     /// 适合开发/测试环境，在应用启动时自动填充数据：
4.     /// FakeData.Init(10); // 生成 10 个 Blog，每个包含 3~5 篇 Post
5.     /// 
6.     publicstaticclassFakeData
7.     {
8.         publicstatic List Blogs = new List();
9.         publicstatic List Posts = new List();
11.         public static void Init(int count)
12.         {
13.             var postId = 1;
14.             var postFaker = new Faker()
15.                 .RuleFor(p => p.PostId, _ => postId++)
16.                 .RuleFor(p => p.Title, f => f.Hacker.Phrase())
17.                 .RuleFor(p => p.Content, f => f.Lorem.Sentence());
19.             var blogId = 1;
20.             var blogFaker = new Faker()
21.                 .RuleFor(b => b.BlogId, _ => blogId++)
22.                 .RuleFor(b => b.Url, f => f.Internet.Url())
23.                 .RuleFor(b => b.Posts, (f, b) =>
24.                 {
25.                     postFaker.RuleFor(p => p.BlogId, _ => b.BlogId);
26.                     var posts = postFaker.GenerateBetween(3, 5);
28.                     // 关键：收集所有 Posts 到静态列表中
29.                     Posts.AddRange(posts);
31.                     return posts;
32.                 });
34.             // 清空旧数据，避免重复调用累积
35.             Blogs.Clear();
36.             Posts.Clear();
38.             Blogs = blogFaker.Generate(count);
39.         }
40.     }
42.     /// 
43.     /// Blog
44.     /// 
45.     publicclassBlog
46.     {
47.         publicint BlogId { get; set; }
48.         publicstring Url { get; set; }
49.         public List Posts { get; set; }
50.     }
52.     /// 
53.     /// Post
54.     /// 
55.     publicclassPost
56.     {
57.         publicint PostId { get; set; }
58.         publicstring Title { get; set; }
59.         publicstring Content { get; set; }
60.         publicint BlogId { get; set; }
61.     }

复制代码

在 Program.cs 启动时填充：

1.     public classProgram
2.     {
3.         public static void Main(string[] args)
4.         {
5.             var builder = WebApplication.CreateBuilder(args);
7.             // 注册 DbContext
8.             builder.Services.AddDbContext(options =>
9.                 options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection")));
11.             var app = builder.Build();
13.             // 应用启动时填充种子数据
14.             using (var scope = app.Services.CreateScope())
15.             {
16.                 var context = scope.ServiceProvider.GetRequiredService();
18.                 // 确保数据库已创建
19.                 context.Database.EnsureCreated();
21.                 // 仅在数据库为空时填充假数据
22.                 if (!context.Blogs.Any())
23.                 {
24.                     FakeData.Init(10); // 生成 10 个 Blog，每个包含 3~5 篇 Post
26.                     context.Blogs.AddRange(FakeData.Blogs);
27.                     context.Posts.AddRange(FakeData.Posts);
28.                     context.SaveChanges();
30.                     Console.WriteLine($"已填充 {FakeData.Blogs.Count} 个博客, {FakeData.Posts.Count} 篇文章");
31.                 }
32.             }
34.             app.MapControllers();
35.             app.Run();
36.         }
37.     }

复制代码

自定义扩展 Bogus 数据集

开发者可以轻松扩展 Bogus，添加自定义的数据生成器：

1.     /// 
2.     /// 为 Bogus 的 Faker 类提供食品相关的自定义假数据扩展方法
3.     /// 
4.     publicstaticclassFoodExtensions
5.     {
6.         /// 
7.         /// 生成一个随机的糖果名称
8.         /// 
9.         /// 
10.         /// 
11.         public static string Candy(this Faker faker)
12.         {
13.             return faker.PickRandom(new[] { "巧克力", "棒棒糖", "口香糖", "软糖", "太妃糖" });
14.         }
16.         /// 
17.         /// 生成一个随机的饮品名称
18.         /// 
19.         /// 
20.         /// 
21.         public static string Drink(this Faker faker)
22.         {
23.             return faker.PickRandom(new[] { "可乐", "雪碧", "橙汁", "咖啡", "牛奶" });
24.         }
25.     }
26.     
27.     // 使用自定义扩展
28.     var faker = new Faker();
29.     Console.WriteLine($"最爱糖果: {faker.Candy()}");
30.     Console.WriteLine($"最爱饮料: {faker.Drink()}");

复制代码

项目源码地址


更多项目实用功能和特性欢迎前往项目开源地址查看
来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！

yyds。多谢分享

感谢分享，下载保存了，貌似很强大

感谢分享

谢谢楼主提供！

感谢分享

用心讨论，共获提升！