EF Core脚手架如何保留数据库原始外键名称？

核心结论 #

EF Core原生的Scaffold-DbContext命令没有直接选项让导航属性使用数据库外键约束名称生成，-UseDatabaseNames仅作用于表和列的命名，导航属性的名称是EF Core根据实体关联关系自动推导的，和数据库外键约束名无关。

高效替代方案 #

1. 自定义EF Core脚手架T4模板

EF Core支持自定义T4模板控制代码生成逻辑，可修改导航属性的生成规则，让它读取数据库外键约束名称来命名：

• 导出默认脚手架模板：

  dotnet ef dbcontext scaffold --list-templates
  dotnet ef dbcontext scaffold --output-dir Templates --template-dir Templates --force "Your_Connection_String" Microsoft.EntityFrameworkCore.SqlServer
  

• 打开EntityType.cs.t4文件，定位到集合导航属性生成代码段，修改名称生成逻辑：
  比如直接使用外键约束名，或做简单格式处理（如去掉FK_前缀）：

  // 示例：用外键约束名作为导航属性名
  var navigationName = foreignKey.ConstraintName;
  // 或处理为驼峰命名：
  var navigationName = foreignKey.ConstraintName.Replace("FK_", "").Split('_')
      .Select(s => char.ToUpper(s[0]) + s.Substring(1))
      .Aggregate((a, b) => a + b);
  

• 使用自定义模板重新生成代码：

  dotnet ef dbcontext scaffold "Your_Connection_String" Microsoft.EntityFrameworkCore.SqlServer -OutputDir Models -TemplateDir Templates
  

2. 使用EF Core Power Tools（推荐）

这是官方认可的可视化扩展，支持灵活的脚手架配置，可直接映射外键约束名到导航属性：

• 在Visual Studio中安装EF Core Power Tools扩展
• 右键项目 → EF Core Power Tools → Reverse Engineer
• 在配置窗口中，找到「Navigation property naming」选项，选择「Use foreign key constraint name」，直接生成符合要求的导航属性

3. 批量修正已生成的代码

如果已用原生脚手架生成代码，可通过脚本或正则批量修正：

• 从数据库查询所有外键约束信息（SQL Server示例）：

  SELECT 
      fk.name AS ForeignKeyName,
      OBJECT_NAME(fk.parent_object_id) AS ParentTable,
      OBJECT_NAME(fk.referenced_object_id) AS ReferencedTable
  FROM sys.foreign_keys fk
  

• 根据查询结果生成替换规则，用IDE批量替换功能（如Visual Studio的正则查找替换），自动修正导航属性名称；也可编写C#脚本遍历实体类文件完成批量替换

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