17370845950

EF Core 中通过 ToTable 和 HasColumnName 自定义表名与列名，优先级高于约定；ToTable 支持指定表名、架构及分表，HasColumnName 用于适配下划线命名、关键字等场景，二者均需在 OnModelCreating 中配置。

EF Core 中自定义表名和列名，主要通过 ToTable 和 HasColumnName 两个 Fluent API 方法实现，它们在 OnModelCreating 中配置，优先级高于约定（如类名自动映射为表名、属性名自动映射为列名）。

用 ToTable 自定义表名

默认情况下，EF Core 将 DbSet 的泛型类型名（如 Blog）作为表名。使用 ToTable 可覆盖该行为，支持指定表名、架构名，甚至同一实体映射到多个表（分表场景）。

• modelBuilder.Entity().ToTable("blogs"); —— 表名改为小写 blogs
• modelBuilder.Entity().ToTable("Posts", "content"); —— 表名 Posts，架构为 content（SQL Server/PostgreSQL 支持）
• modelBuilder.Entity().ToTable("blog_archive_2025"); —— 静态分表命名，适用于归档表

用 HasColumnName 自定义列名

默认列名与属性名一致。当数据库字段使用下划线命名（如 created_at）、保留字（如 order）或需兼容旧库时，用 HasColumnName 显式指定列名。

• modelBuilder.Entity().Property(e => e.CreatedTime).HasColumnName("created_at");
• modelBuilder.Entity().Property(e => e.Order).HasColumnName("order_number"); —— 避免用 Order 作列名（SQL 关键字）
• 可链式调用：.HasColumnName("is_active").HasDefaultValue(false)

批量配置与约定优先技巧

若项目统一采用 snake_case 命名，不建议逐个调用 HasColumnName，而应结合约定（ModelBuilder.Conventions）或循环配置：

• EF Core 5+ 可用 modelBuilder.UseSnakeCaseNamingConvention()（需安装 Pomelo.EntityFrameworkCore.MySql 或自定义约定）
• 手动遍历实体属性：foreach (var property in entityType.GetProperties()) { property.SetColumnName(ToSnakeCase(property.Name)); }
• ToTable 和 HasColumnName 不会覆盖主键/外键的约束名，索引或约束名需单独用 HasIndex/HasConstraintName

注意事项与常见问题

这些配置只影响模型映射，不改变 C# 属性本身；迁移生成的 SQL 会反映新名称，但已有数据库需手动处理重命名（如用 migrationBuilder.RenameColumn）。

• 配置顺序无关紧要，但必须在 OnModelCreating 中完成，运行时不可修改
• 若同时用数据注解（如 [Column("xxx")]）和 Fluent API，Fluent API 优先级更高
• 查询时仍用 C# 属性名（Where(x => x.Title == "...")），EF Core 自动翻译为对应列名

基本上就这些。掌握 ToTable 和 HasColumnName 就能灵活适配各种数据库命名规范，既保持代码清晰，又不被底层表结构*。