Migrations 是 EF Core 中管理数据库架构变更的机制,通过将 C# 模型类的更改转换为可追踪的 SQL 脚本,实现数据库与代码结构的同步。当模型发生变化时(如新增属性或表),需添加迁移记录(dotnet ef migrations add),生成包含 Up()/Down() 方法的迁移文件,再通过 dotnet ef database update 应用到数据库。支持回滚操作(--to 指定版本)和生成 SQL 脚本(script 命令)供生产环境审核,确保变更安全可控,配合版本工具提升团队协作效率。

Migrations(迁移) 是 EF Core 中用于管理数据库架构变更的机制。它能将你在 C# 模型类中的更改(比如新增一个属性、修改字段类型或添加新表)转换为对应的数据库结构变更脚本,从而让你以代码方式安全、可追踪地更新数据库。
迁移的核心作用
当你的实体模型发生变化时,数据库并不会自动同步这些变化。Migrations 提供了一种方式,把模型的变更记录下来,并生成可以执行的 SQL 脚本,让数据库结构与代码保持一致。例如:你给一个 Blog 类添加了 CreatedDate 属性,通过添加并应用迁移,EF Core 会生成一条“为 Blog 表添加 CreatedDate 列”的操作,并在数据库中执行它。
如何使用 Migrations 管理数据库变更
以下是典型的迁移操作流程:
- 启用迁移:首次使用时,在项目中初始化迁移系统。通常只需执行一次。
- 添加迁移:每次模型变更后,创建一个新的迁移记录。
- 更新数据库:将迁移应用到目标数据库,使其结构同步。
- 回滚迁移:必要时可以撤销最近的变更。
具体操作步骤(通过命令行)
确保已安装 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() 定义了撤销该操作的逆向操作(如删除列)。这使得迁移可以双向进行。
生产环境中的建议
在开发阶段频繁使用迁移没有问题,但在生产环境中需谨慎:
- 每次迁移生成后应审查生成的 SQL 是否合理,尤其是涉及数据丢失的操作(如删除列)。
- 可通过
script命令生成 SQL 脚本,交由 DBA 审核后再执行:
dotnet ef migrations script
update,推荐导出脚本并人工确认。基本上就这些。Migrations 让数据库架构演变得以版本化控制,配合 Git 等工具,团队协作更安全高效。










