EF Core 迁移是通过C#代码同步模型与数据库结构的推荐方式，支持初始化、增量变更、回滚及生产环境安全实践。

EF Core 的迁移（Migrations）是将代码模型变更同步到数据库的推荐方式，核心在于用 C# 代码描述数据库结构演进，避免手动写 SQL 或丢失版本历史。

初始化迁移：从模型生成第一个迁移文件

当你已有实体类和 DbContext，但数据库还不存在或为空时，先执行：

• dotnet ef migrations add InitialCreate —— 生成名为 InitialCreate 的迁移类（含 Up/Down 方法）
• dotnet ef database update —— 执行迁移，创建数据库及表结构

注意：确保项目已安装 Microsoft.EntityFrameworkCore.Tools 包，并在 CLI 中处于包含 DbContext 的项目目录下。

后续变更：添加新字段、新表或修改关系

改完实体类或 Fluent API 配置后，只需再加一次迁移：

• dotnet ef migrations add AddUserEmailAndStatus —— 名称建议体现变更意图
• EF Core 会自动对比当前模型与上一个 Migration.cs 中的快照（ModelSnapshot），生成差异代码
• 若自动生成不理想（如误删列），可手动编辑 Up() 方法，但需同步调整 Down()

管理迁移历史与回滚

迁移不是单向的，支持安全回退和版本控制：

• dotnet ef database update 20250101120000_InitialCreate —— 回退到指定迁移（含其本身）
• dotnet ef database update 0 —— 清空数据库（慎用，仅开发环境）
• 所有迁移文件都应纳入源码管理，团队成员拉取新迁移后运行 update 即可同步库结构

生产环境注意事项

上线前务必验证迁移行为，避免阻塞部署：

• 用 dotnet ef migrations script 生成 SQL 脚本，供 DBA 审核或离线执行
• 避免在迁移中写业务逻辑（如插入种子数据），改用 HasData() 或独立初始化方法
• 大表加索引或非空字段时，考虑分步迁移（先加可空列 → 补数据 → 改为不可空），防止锁表过久

基本上就这些。迁移本质是“模型即 Schema”，保持实体与迁移一致，就能让数据库跟着代码一起成长。