.NET如何使用Entity Framework Core进行数据库迁移

来源：这里教程网时间：2026-02-21 17:30:34 作者：

在 .NET 中使用 Entity Framework Core（EF Core）进行数据库迁移，是一种将代码中的模型变更同步到数据库结构的有效方式。通过迁移，你可以安全地更新数据库架构，同时保留现有数据。整个过程无需手动编写 SQL 脚本，提升开发效率。

启用 EF Core 迁移的基本条件

要使用迁移功能，项目中必须满足以下条件：

已安装 Microsoft.EntityFrameworkCore.Tools 包（开发时使用） 配置了 DbContext 并在 Program.cs 或 Startup.cs 中注册服务 数据库连接字符串正确配置 建议：使用包管理器控制台或 .NET CLI 执行迁移命令，推荐后者以便跨平台开发。

创建并应用第一次迁移

当你定义好实体类和 DbContext 后，可以开始创建初始迁移：

打开终端，进入项目目录 运行命令：dotnet ef migrations add InitialCreate EF Core 会在项目中生成一个 Migrations 文件夹，并添加表示当前模型状态的迁移文件 接着运行：dotnet ef database update，将迁移应用到数据库

此时数据库会根据你的实体模型自动创建表结构。

更新模型后进行后续迁移

当修改实体类（如添加属性、新实体或更改关系）后，需生成新的迁移：

例如给 User 类添加 Email 属性 执行：dotnet ef migrations add AddEmailToUser EF Core 会对比当前模型与上一次迁移的状态，生成差异化的变更脚本 再次运行 dotnet ef database update 应用变更

这个过程会为 User 表添加 Email 列，不影响已有数据。

查看和管理迁移历史

你可以随时检查当前数据库状态：

dotnet ef migrations list：列出所有已定义的迁移 dotnet ef database update [MigrationName]：回滚或跳转到指定迁移版本 dotnet ef migrations remove：删除最后一次生成的迁移（仅限未应用到数据库的）

注意：已经应用到生产环境的迁移不应轻易删除或修改，应通过新增迁移来修复问题。

基本上就这些。只要保持模型与迁移同步，EF Core 能帮你高效管理数据库演进。关键是每次模型变更后记得添加迁移并及时更新数据库。不复杂但容易忽略。