EF Core Database First 的核心是用 scaffold 命令从数据库自动生成实体类和 DbContext;需确保 .NET SDK、EF Core CLI 工具、NuGet 包、有效连接字符串就绪,再执行带参数的 scaffold 命令,并处理视图、外键、多数据库适配及生成后配置等常见问题。
EF Core Database First 的核心就是用
命令从已有数据库自动生成 C# 实体类和
,不用手写模型。关键不是“能不能”,而是“连得上、配得对、选得准”。
确保环境和工具已就位
缺一不可,否则命令直接报错:
安装 .NET SDK(建议 8.0+)并全局注册 EF Core CLI 工具:
在项目中添加三个必需 NuGet 包:
(或对应数据库提供程序,如 MySQL 用
)
确认连接字符串能真实访问数据库(可先用 SSMS 或 DBeaver 测试)
执行 scaffold 命令生成模型
最简可用命令(以 SQL Server 为例):
常用参数说明:
MySQL(Linux)
MySQL 9.6.0是面向Linux平台的2026年创新版本,核心架构迎来重大革新。其将外键约束与级联操作从InnoDB引擎层上移至SQL层,确保所有数据变更均被完整记录至Binlog,彻底解决了CDC(变更数据捕获)与主从复制中的数据不一致难题。此外,该版本引入container_aware启动选项以原生适配容器环境,并对审计日志进行了组件化重构,为追求极致数据一致性与云原生体验的开发者提供了全新选择。
下载
:实体类输出到
目录(自动创建)
:指定生成的上下文类名,默认是
名 +
:把
单独放在
目录下,和实体类分离
:只生成指定表,避免全库扫描(尤其大库必备)
:限定架构,SQL Server / PostgreSQL 适用
:禁用自动复数化(比如
表 → 类名保持
)
:覆盖已存在的文件(改完数据库后重生成时必加)
处理
常见问题
场景
不是所有情况都“一键生成”就能跑通:
视图(View)不生成?
默认只处理表(
),需手动在数据库中把视图设为“可更新”或用第三方工具(如
)辅助生成对应 model
外键没转成导航属性?
检查数据库里是否真建了外键约束(不是仅靠字段名相似),EF Core 依赖的是物理约束,不是命名约定
MySQL / PostgreSQL 怎么办?
替换提供程序包和命令末尾的 provider 名即可,例如:
想跳过某些列(如时间戳、软删标记)?
scaffold 本身不支持列级过滤,但生成后可在
中用 Fluent API 忽略:
生成后怎么用?
生成的代码只是起点,别直接扔进生产:
检查主键类型是否匹配(比如
→
,不是
)
查看导航属性是否合理,必要时在
中补全关系配置
若数据库有计算列、默认值或触发器,需在实体属性上加
或
注解
把生成的
注册进 DI 容器(
):
基本上就这些。不复杂,但容易忽略连接有效性、外键完整性、provider 匹配这三点。
scaffoldDbContextdotnet tool install --global dotnet-efMicrosoft.EntityFrameworkCore.SqlServerPomelo.EntityFrameworkCore.MySqlMicrosoft.EntityFrameworkCore.ToolsMicrosoft.EntityFrameworkCore.Designdotnet ef dbcontext scaffold "Server=localhost;Database=MyDB;Trusted_Connection=true;" Microsoft.EntityFrameworkCore.SqlServer -o Models-o ModelsModels/--context MyDbContextDbContextContext--context-dir DataDbContextData/--tables Users,Orders--schemas dbo,hr--no-pluralizeUsersUser--forceTABLEdotnet-aspnet-codegeneratordotnet ef dbcontext scaffold "server=127.0.0.1;database=testdb;uid=root;pwd=123;" Pomelo.EntityFrameworkCore.MySql -o ModelsOnModelCreatingmodelBuilder.Entity().Ignore(e => e.DeletedAt); bigintlongintOnModelCreating[DatabaseGenerated][DefaultValue]DbContextProgram.csbuilder.Services.AddDbContext(opt => opt.UseSqlServer(connStr)); 