EF Core数据库优先脚手架：如何自定义一对一导航属性命名

我完全明白这个痛点——EF Core默认生成的IdProductNavigation这种导航属性名确实太不直观了，尤其是习惯了EF6里用关联表名+序号的命名方式之后。既然你没法修改外键列名，下面几个方案可以帮你自定义导航属性的名称，按推荐度排序：

1. 利用数据库注释（最推荐的持久化方案） #

EF Core的脚手架工具会读取数据库对象的注释，你可以给外键列添加特定格式的注释，让脚手架自动识别并生成你想要的导航属性名。

针对SQL Server： #

给目标外键列添加MS_Description扩展属性，格式为NavigationPropertyName: [自定义名称]，执行以下SQL：

EXEC sp_addextendedproperty 
    @name = N'MS_Description', 
    @value = N'NavigationPropertyName: Product', 
    @level0type = N'SCHEMA', @level0name = N'dbo', 
    @level1type = N'TABLE', @level1name = N'Invoice', 
    @level2type = N'COLUMN', @level2name = N'IdProduct';

执行完成后，重新运行脚手架命令，生成的导航属性就会变成public Product Product { get; set; }，而不是默认的IdProductNavigation。

针对PostgreSQL： #

直接给列添加注释，格式和上面一致：

COMMENT ON COLUMN invoice.idproduct IS 'NavigationPropertyName: Product';

2. 配合脚手架参数强化注释识别 #

运行脚手架命令时添加--data-annotations参数，能让工具更优先读取数据库注释中的配置，确保自定义名称生效：

dotnet ef dbcontext scaffold "你的数据库连接字符串" Microsoft.EntityFrameworkCore.SqlServer --data-annotations --output-dir Models

3. 用Fluent API手动配置（无需修改数据库） #

如果没法修改数据库注释，你可以在DbContext中手动配置导航属性名称，而且为了避免后续脚手架覆盖配置，建议把配置放在单独的实体配置类中：

首先创建实体配置类：

public class InvoiceConfiguration : IEntityTypeConfiguration<Invoice>
{
    public void Configure(EntityTypeBuilder<Invoice> builder)
    {
        // 配置一对一关联，指定自定义导航属性名
        builder.HasOne(i => i.Product)
            .WithOne() // 这里根据实际情况配置反向导航（如果有的话）
            .HasForeignKey<Invoice>(i => i.IdProduct);
    }
}

然后在DbContext的OnModelCreating方法中注册这个配置：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.ApplyConfiguration(new InvoiceConfiguration());
    // 其他实体配置...
}

这样即使后续重新运行脚手架生成代码，只要不删除这个配置类，导航属性的自定义名称就会一直生效。

4. 手动修改后增量生成（不推荐，仅临时应急） #

如果以上方案都没法用，你可以先生成初始代码，手动把IdProductNavigation改成Product，后续反向工程时加上--force参数。但要注意：这个参数会覆盖现有文件，所以每次生成后你都需要重新修改导航属性名，非常繁琐，只适合临时应急场景。

内容的提问来源于stack exchange，提问作者neothoms