Migrations 是 EF Core 中管理数据库架构变更的机制,通过将 C# 模型类的更改转换为可追踪的 SQL 脚本,实现数据库与代码结构的同步。当模型发生变化时(如新增属性或表),需添加迁移记录(dotnet ef migrations add),生成包含 Up()/Down() 方法的迁移文件,再通过 dotnet ef database update 应用到数据库。支持回滚操作(--to 指定版本)和生成 SQL 脚本(script 命令)供生产环境审核,确保变更安全可控,配合版本工具提升团队协作效率。
Migrations(迁移) 是 EF Core 中用于管理数据库架构变更的机制。它能将你在 C# 模型类中的更改(比如新增一个属性、修改字段类型或添加新表)转换为对应的数据库结构变更脚本,从而让你以代码方式安全、可追踪地更新数据库。
例如:你给一个 Blog 类添加了 CreatedDate 属性,通过添加并应用迁移,EF Core 会生成一条“为 Blog 表添加 CreatedDate 列”的操作,并在数据库中执行它。
以下是典型的迁移操作流程:
确保已安装 Microsoft.EntityFrameworkCore.Tools 包,并在项目目录下使用 .NET CLI 或 Package Manager Console。
1. 添加初始迁移
当你第一次启用迁移时:dotnet ef migrations add InitialCreate这会在项目中生成一个
Migrations 文件夹,并创建初始迁移文件(包含创建所有当前模型对应表的代码)。2. 应用迁移到数据库
执行以下命令将迁移更新到数据库:dotnet ef database update如果数据库不存在,会自动创建;否则按迁移历史逐步更新结构。
3. 修改模型后添加新迁移
例如给Blog 类增加一个 Description 字符串属性:dotnet ef migrations add AddBlogDescriptionEF Core 会对比当前模型与上一次迁移的状态,自动生成新增列的代码。
4. 更新数据库以应用变更
dotnet ef database update这条命令会执行所有未应用的迁移,包括刚刚添加的
AddBlogDescription。5. 回退迁移(可选)
如果你想撤销最后一次迁移:dotnet ef database update PreviousMigrationName或者直接回退到上一步:
dotnet ef database update --to PreviousMigrationName
每个迁移生成两个文件:
Timestamp_AddBlogDescription.cs:C# 类,包含 Up() 和 Down() 方法。Timestamp_AddBlogDescription.Designer.cs:设计时信息,一般无需手动修改。Up() 定义了应用此迁移时要执行的操作(如添加列),Down() 定义了撤销该操作的逆向操作(如删除列)。这使得迁移可以双向进行。
在开发阶段频繁使用迁移没有问题,但在生产环境中需谨慎:
否合理,尤其是涉及数据丢失的操作(如删除列)。script 命令生成 SQL 脚本,交由 DBA 审核后再执行:dotnet ef migrations script
update,推荐导出脚本并人工确认。基本上就这些。Migrations 让数据库架构演变得以版本化控制,配合 Git 等工具,团队协作更安全高效。