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）、复杂索引选项（包含列、排序方向等） 配置优先级最高，会覆盖约定和数据注解，避免隐式冲突
基本上就这些。上手不难，关键是养成“实体归实体、配置归配置”的习惯。
