EF Core如何自定义表名和列名？ToTable和HasColumnName方法怎么用

在使用EF Core操作数据库时，实体类与数据库表、实体属性的映射默认遵循名称一致的规则，但实际的数据库设计往往有独立的命名规范，比如表名需要加前缀、列名需要使用下划线分隔的命名方式，这时候就需要通过EF Core提供的配置方法来自定义表名和列名，其中ToTable和HasColumnName是最常用的两个配置方法。

EF Core自定义表名的方法：ToTable

ToTable方法用于配置实体类对应的数据库表名称，支持配置表名、表架构，也支持配置表的别名等场景。我们可以在DbContext的OnModelCreating方法中，通过Fluent API调用ToTable方法完成表名自定义。

基础用法：仅指定表名

如果只需要修改表名，直接给ToTable方法传入目标表名字符串即可，下方是实体类和对应的配置示例：

// 实体类定义
public class User
{
    public int Id { get; set; }
    public string UserName { get; set; }
    public string Email { get; set; }
}

// DbContext中的配置
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 将User实体映射到名为sys_user的表
    modelBuilder.Entity<User>()
        .ToTable("sys_user");
}

进阶用法：指定表名和架构

如果数据库表属于特定的架构，比如SQL Server的dbo架构之外的自定义架构，可以在ToTable方法的第二个参数传入架构名称：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 将User实体映射到admin架构下的sys_user表
    modelBuilder.Entity<User>()
        .ToTable("sys_user", "admin");
}

EF Core自定义列名的方法：HasColumnName

HasColumnName方法用于配置实体属性对应的数据库列名称，同样在OnModelCreating方法中通过Fluent API调用，针对单个属性进行配置即可。

基础用法：指定单个列名

下方示例将User实体的UserName属性映射到数据库的user_name列，Email属性映射到user_email列：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    var userEntity = modelBuilder.Entity<User>();
    // 配置表名
    userEntity.ToTable("sys_user");
    // 配置列名
    userEntity.Property(u => u.UserName).HasColumnName("user_name");
    userEntity.Property(u => u.Email).HasColumnName("user_email");
    // Id属性默认映射到id列，也可以显式配置
    userEntity.Property(u => u.Id).HasColumnName("id");
}

同时配置列类型和列名

HasColumnName可以和其他列配置方法链式调用，比如同时指定列的数据类型和列名：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<User>()
        .ToTable("sys_user")
        .Property(u => u.UserName)
        .HasColumnName("user_name")
        .HasColumnType("varchar(50)");
}

两个方法的注意事项

• ToTable是实体级别的配置，一个实体只能调用一次ToTable，多次调用后面的配置会覆盖前面的配置。
• HasColumnName是属性级别的配置，每个需要自定义列名的属性都需要单独调用该方法，未调用的属性会默认使用属性名作为列名。
• 如果实体使用了[Table]特性标注表名，同时使用ToTable方法配置，ToTable的配置优先级更高，会覆盖特性的配置。
• 如果属性使用了[Column]特性标注列名，同时使用HasColumnName方法配置，HasColumnName的配置优先级更高，会覆盖特性的配置。

完整配置示例

下方是一个完整的DbContext配置示例，同时使用了ToTable和HasColumnName完成表名和列名的自定义：

using Microsoft.EntityFrameworkCore;

public class AppDbContext : DbContext
{
    public DbSet<User> Users { get; set; }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        // 配置数据库连接，这里使用SQL Server示例
        optionsBuilder.UseSqlServer("Server=127.0.0.1;Database=TestDb;Trusted_Connection=True;");
    }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        // 配置User实体
        modelBuilder.Entity<User>()
            .ToTable("sys_user", "dbo") // 表名sys_user，架构dbo
            .Property(u => u.Id)
                .HasColumnName("id")
                .ValueGeneratedOnAdd(); // 配置自增
        modelBuilder.Entity<User>()
            .Property(u => u.UserName)
                .HasColumnName("user_name")
                .HasMaxLength(50)
                .IsRequired();
        modelBuilder.Entity<User>()
            .Property(u => u.Email)
                .HasColumnName("user_email")
                .HasMaxLength(100);
    }
}

public class User
{
    public int Id { get; set; }
    public string UserName { get; set; }
    public string Email { get; set; }
}

通过上述配置，EF Core在生成数据库或者执行数据操作时，就会使用我们自定义的sys_user作为表名，使用user_name、user_email作为对应的列名，完全符合自定义的数据库命名规范。

EF_CoreToTableHasColumnName自定义表名自定义列名修改时间：2026-06-13 10:54:29