深入探索 EF Core 数据库迁移与表生成实体-51CTO.COM

一、引言

Entity Framework Core（EF Core）作为一款强大的对象关系映射（ORM）框架，在.NET 开发中广泛应用于数据库交互。其中，数据库迁移功能允许我们以代码优先的方式管理数据库架构的演变，而从现有数据库表生成实体类则为逆向工程提供了便利，大大提高开发效率。本文将详细讲解这两个关键操作的具体步骤，并附上实例，帮助读者快速上手。

二、EF Core 数据库迁移

（一）环境搭建

首先，确保你的项目已安装必要的 NuGet 包。对于一个.NET Core 项目，需要引入 Microsoft.EntityFrameworkCore 、 Microsoft.EntityFrameworkCore.Design 、 Microsoft.EntityFrameworkCore.SqlServer （这里以 SQL Server 为例，若使用其他数据库，如 MySQL，则引入对应的包，如 Pomelo.EntityFrameworkCore.MySql ）。

（二）创建 DbContext 类

DbContext 是 EF Core 与数据库交互的核心类，它负责协调实体类与数据库之间的操作。例如，创建一个名为 MyDbContext 的类：

复制

using Microsoft.EntityFrameworkCore;

public class MyDbContext : DbContext
{
    public MyDbContext(DbContextOptions<MyDbContext> options) : base(options)
    {
    }

    public DbSet<Blog> Blogs { get; set; }
    public DbSet<Post> Posts { get; set; }
}1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.

这里定义了两个 DbSet 属性，分别对应 Blog 和 Post 实体（后续会详细讲解实体类），它们代表数据库中的表。

（三）配置数据库连接

在 Startup.cs （ASP.NET Core 项目）或程序入口点处，配置数据库连接字符串并将 DbContext 注入到服务容器中：

复制

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        var connectionString = "Server=(localdb)\\mssqllocaldb;Database=MyBlogDb;Trusted_Connection=True;";
        services.AddDbContext<MyDbContext>(options =>
            options.UseSqlServer(connectionString));

        // 其他服务注册
    }

    // 其他配置方法
}1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.

（四）创建初始迁移

打开命令行工具，切换到项目目录，执行以下命令：

复制

dotnet ef migrations add InitialCreate1.

这一步会在项目中创建一个 Migrations 文件夹，里面包含了描述数据库初始架构的代码文件。例如，生成的迁移文件可能包含创建 Blogs 和 Posts 表的代码，类似：

复制

public partial class InitialCreate : Migration
{
    protected override void Up(MigrationBuilder migrationBuilder)
    {
        migrationBuilder.CreateTable(
            name: "Blogs",
            columns: table => new
            {
                BlogId = table.Column<int>(nullable: false)
                   .Annotation("SqlServer:Identity", "1, 1"),
                Url = table.Column<string>(nullable: true)
            },
            constraints: table =>
            {
                table.PrimaryKey("PK_Blogs", x => x.BlogId);
            });

        migrationBuilder.CreateTable(
            name: "Posts",
            columns: table => new
            {
                PostId = table.Column<int>(nullable: false)
                   .Annotation("SqlServer:Identity", "1, 1"),
                Title = table.Column<string>(nullable: true),
                Content = table.Column<string>(nullable: true),
                BlogId = table.Column<int>(nullable: false)
            },
            constraints: table =>
            {
                table.PrimaryKey("PK_Posts", x => x.PostId);
                table.ForeignKey(
                    name: "FK_Posts_Blogs_BlogId",
                    column: x => x.BlogId,
                    principalTable: "Blogs",
                    principalColumn: "BlogId",
                    onDelete: ReferentialAction.Cascade);
            });
    }

    protected override void Down(MigrationBuilder migrationBuilder)
    {
        migrationBuilder.DropTable(
            name: "Posts");
        migrationBuilder.DropTable(
            name: "Blogs");
    }
}1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.

Up 方法定义了如何将数据库迁移到新版本，即创建表； Down 方法则用于回滚迁移，删除相应表。

（五）应用迁移到数据库

执行以下命令将迁移应用到数据库：

复制

dotnet ef database update1.

此时，数据库中会创建 Blogs 和 Posts 表，架构与迁移文件中定义一致。

三、从数据库表生成实体

（一）安装反向工程工具

EF Core 提供了反向工程工具，同样需要通过 NuGet 安装。执行命令：

复制

dotnet tool install --global dotnet-ef1.

确保工具安装成功。

（二）生成实体类

在命令行中，执行以下命令：

复制

dotnet ef dbcontext scaffold "Server=(localdb)\\mssqllocaldb;Database=MyBlogDb;Trusted_Connection=True;" Microsoft.EntityFrameworkCore.SqlServer -o Models1.

这里的连接字符串指向要逆向工程的数据库， Microsoft.EntityFrameworkCore.SqlServer 表明数据库类型， -o Models 指定生成的实体类文件输出到 Models 文件夹。

生成的实体类会自动包含对应表的属性，例如 Blog 实体可能如下：

复制

public partial class Blog
{
    public int BlogId { get; set; }
    public string Url { get; set; }
    public ICollection<Post> Posts { get; set; }
}
 
 
 Post  实体也会有相应属性，并且会自动配置与  Blog  的关联关系，类似：
 
public partial class Post
{
    public int PostId { get; set; }
    public string Title { get; set; }
    public string Content { get; set; }
    public int BlogId { get; set; }
    public virtual Blog Blog { get; set; }
}1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.

四、总结

通过 EF Core 的数据库迁移功能，我们能以优雅的代码方式管理数据库架构变化，适应项目迭代需求。而从数据库表生成实体的逆向工程操作，则为对接已有数据库、快速构建数据访问层提供了高效途径。掌握这两项技术，能让.NET 开发者在数据库驱动的应用开发中如虎添翼，提升开发效率与代码质量，轻松应对复杂的数据持久化场景。

在实际项目中，可根据团队开发流程灵活运用，如在新项目启动时利用迁移创建初始架构，后期迭代持续更新；对接遗留数据库时，先逆向生成实体再按需优化调整，充分发挥 EF Core 的强大功能。