ef core fluent api 是在 onmodelcreating 方法中通过 modelbuilder 配置模型的推荐方式，比数据注解更灵活、解耦更强，适合复杂场景；配置必须在此方法中编写，建议拆分到实现 ientitytypeconfiguration 的独立类中；支持表名列名修改、主键设置、索引与关系配置等。
EF Core Fluent API 是在 OnModelCreating 方法中通过 ModelBuilder 对象配置模型的推荐方式，比数据注解更灵活、解耦更强，也更适合复杂场景。它不依赖属性标记，所有配置集中管理，便于维护和跨数据库适配。
在哪写 Fluent API 配置
重写 DbContext 类中的 OnModelCreating 方法，在里面调用 modelBuilder 的链式方法：
- 配置入口固定：必须在
protected override void OnModelCreating(ModelBuilder modelBuilder)中编写 - 不能在构造函数或
OnConfiguring中调用，否则会报错 - 建议把不同实体的配置拆到单独的配置类（实现
IEntityTypeConfiguration<t></t>），再在OnModelCreating中批量注册，保持主方法简洁
最常用的基础配置示例
以下是在 OnModelCreating 中直接写的典型操作：
-
改表名：
modelBuilder.Entity<user>().ToTable("Users")</user> -
改列名 + 类型 + 长度：
modelBuilder.Entity<user>().Property(u => u.Email).HasColumnName("email_address").HasColumnType("varchar(255)").IsRequired()</user> -
设主键 + 自增：
modelBuilder.Entity<order>().HasKey(o => o.Id); modelBuilder.Entity<order>().Property(o => o.Id).ValueGeneratedOnAdd()</order></order> -
设复合主键：
modelBuilder.Entity<orderitem>().HasKey(oi => new { oi.OrderId, oi.ProductId })</orderitem>
索引与关系怎么配
索引和导航关系是性能和数据完整性关键，Fluent API 提供清晰语法：
-
单列唯一索引：
modelBuilder.Entity<user>().HasIndex(u => u.Email).IsUnique()</user> -
复合索引（带自定义名）：
modelBuilder.Entity<user>().HasIndex(u => new { u.Status, u.CreatedAt }).HasDatabaseName("IX_Users_Status_CreatedAt")</user> -
一对多关系（显式外键）：
modelBuilder.Entity<post>().HasOne(p => p.Blog).WithMany(b => b.Posts).HasForeignKey(p => p.BlogId)</post> -
多对多（EF Core 5+）：
modelBuilder.Entity<student>().HasMany(s => s.Teachers).WithMany(t => t.Students).UsingEntity(j => j.ToTable("StudentTeacher"))</student>
为什么优先用 Fluent API 而不是特性
这不是“好不好看”的问题，而是工程实践的合理性：
- 实体类专注业务逻辑，不掺杂数据库映射细节
- 同一实体可适配不同数据库（比如 SQL Server 用
nvarchar，MySQL 用varchar），只需在配置里加判断，不用改实体 - 支持数据注解做不到的事：比如配置影子属性、值转换器、过滤全局查询条件（Global Query Filters）、复杂索引选项（包含列、排序方向等）
- 配置优先级最高，会覆盖约定和数据注解，避免隐式冲突
基本上就这些。上手不难，关键是养成“实体归实体、配置归配置”的习惯。
