贝利信息

EF Core如何自定义复数化命名 EF Core Pluralization服务配置

日期:2026-01-04 00:00 / 作者:星降
EF Core 默认对实体类名自动复数化,但无全局关闭开关;需在 OnModelCreating 中用 ToTable 显式指定单数表名或批量处理,配合 SetColumnName 统一列名风格。

EF Core 默认会对实体类名自动复数化,比如 User 类映射到数据库表时变成 UsersProduct 变成 Products。这个行为由内置的 PluralizationService 控制,但默认只在部分语言环境(如英语)下启用,且不可直接配置开关——它其实是通过约定隐式生效的。要真正自定义或禁用复数化,核心方法是绕过默认约定,显式指定表名和列名

关闭复数化:统一使用单数表名

EF Core 没有全局“关闭复数化”的开关,但可通过以下方式彻底规避:

自定义复数化规则(需替换服务)

.NET 6+ 支持注入自定义 IPluralizer,但 EF Core 官方并未提供可替换的 PluralizationService 接口实现。实际可行路径是:

配合数据库列名统一风格

复数化问题常伴随列名风格不一致(如 using Humanizer;FirstName)。建议同步配置列名小写下划线:

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    foreach (var entityType in modelBuilder.Model.GetEntityTypes())
    {
        modelBuilder.Entity(entityType.ClrType).ToTable(entityType.ClrType.Name);

        foreach (var property in entityType.GetProperties())
        {
            var columnName = property.Name.ToSnakeCase(); // 需自行实现或用 Humanizer
            property.SetColumnName(columnName);
        }
    }
}

基本上就这些。不需要动底层服务,靠 first_nameToTable 就能完全掌控命名,既稳定又易维护。