EF Core怎么做数据库第一个版本的迁移 EF Core初始化迁移方法

来源：这里教程网时间：2026-02-21 17:36:19 作者：

EF Core 初始化数据库迁移，核心就是用 dotnet ef migrations add 命令创建第一个迁移文件，再用 dotnet ef database update 应用到数据库。

确保项目已正确配置 EF Core

在运行迁移命令前，必须确认以下几点：

项目中已安装 Microsoft.EntityFrameworkCore.Design 包（开发时必需） DbContext 已定义，并在
Program.cs
或
Startup.cs
中通过
AddDbContext
注册（含连接字符串）项目能被识别为“启动项目”或通过
--project
/
--startup-project
明确指定 连接字符串指向一个**尚不存在的数据库**（EF Core 会自动创建库，但不能是只读或权限不足的实例）

执行第一个迁移（Initial Migration）

打开终端（确保在包含

.csproj

的项目目录下），运行：

dotnet ef migrations add InitialCreate

这个命令会：

扫描当前 DbContext 中所有
DbSet<t></t>
对应的实体类 对比当前模型与“空数据库”的差异（因为还没有任何迁移） 生成一个名为
InitialCreate
的迁移文件（含
Up
和
Down
方法）同时生成一个
ModelSnapshot
文件，用于后续增量比对

应用迁移并创建数据库

执行以下命令将迁移写入数据库：

dotnet ef database update

效果是：

如果数据库不存在，EF Core 自动创建它（仅限 SQL Server、SQLite、PostgreSQL 等支持的提供程序） 运行
InitialCreate.Up()
中的建表、主键、索引等 SQL 在数据库中新建
__EFMigrationsHistory
表，并记录本次迁移 ID

常见问题与提醒

遇到报错？大概率是这几类：

“No project was found”：检查是否在正确的项目目录下；或显式指定：
dotnet ef migrations add Initial --project MyDataProject --startup-project MyWebApp
“Unable to create a DbContext”：通常是 DI 配置不完整，比如缺少
UseSqlServer
或连接字符串为空/无效 手动改过迁移文件后出错：首次迁移尽量别手改；如需调整（如加默认值、约束），应在实体配置（
OnModelCreating
）中声明，而非直接编辑迁移代码 想跳过迁移直接建库？ 不推荐。即使调用
context.Database.EnsureCreated()
，它也无法生成迁移历史，后续无法做版本管理

基本上就这些。第一次迁移不复杂，但容易忽略设计包和启动上下文配置。