EF Core 初始化数据库迁移的核心是先执行 dotnet ef migrations add InitialCreate 创建首次迁移文件，再运行 dotnet ef database update 自动创建数据库并应用迁移；需确保已安装 Microsoft.EntityFrameworkCore.Design 包、正确注册 DbContext、指定有效启动项目及指向不存在的数据库连接字符串。
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对应的实体类 - 对比当前模型与“空数据库”的差异（因为还没有任何迁移）
- 生成一个名为
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()，它也无法生成迁移历史，后续无法做版本管理
基本上就这些。第一次迁移不复杂，但容易忽略设计包和启动上下文配置。
