C#的Migrations在EF Core中是什么?如何管理数据库架构的变更?

来源:这里教程网 时间:2026-02-21 17:31:15 作者:

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 AddBlogDescription
EF 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 等工具,团队协作更安全高效。

相关推荐

热文推荐