在.NET平台的持久化方案中，Code First倡导以业务领域模型为核心，先编写普通的C#对象（POCO），然后根据这些对象推导出数据库的表结构。这种方式将开发者的注意力从繁琐的SQL建表语句转移到了业务实体设计上，使得系统设计更加面向对象。
什么是Code First模式及其核心优势
Code First是Entity Framework Core提供的一种建模方式，与传统的Database First（数据库优先）截然相反。在Database First模式下，数据库已经存在，开发者需要通过工具反向生成实体类；而在Code First模式下，开发者直接在代码中定义实体类，随后通过命令行工具将这些类转化为数据库中的表。
这种模式的核心优势在于高度的业务聚焦和版本控制友好。由于所有的数据模型都是以C#代码的形式存在，它们可以完美地融入Git等版本控制系统，每一次模型变更都有迹可循。此外，Code First支持丰富的数据注解和Fluent API配置，开发者可以精确控制表名、列名、主键、外键以及索引等数据库级别的细节，而无需编写任何SQL语句。
另一个显著优势是团队协作效率的提升。当多名开发者并行开发不同的功能模块时，只需各自修改实体类并生成迁移文件，框架会自动合并这些变更并同步到目标数据库中。这极大地降低了数据库结构管理的沟通成本，使得持续集成和自动化部署变得更加顺畅。
如何定义实体类与上下文类
要使用Code First，首先需要创建实体类。实体类通常是继承自普通基类或实现特定接口的C#类，它们代表了数据库中的一张表。例如，我们定义一个简单的博客文章实体类，包含主键、标题和内容属性。
public class BlogPost
{
public int Id { get; set; }
public string Title { get; set; }
public string Content { get; set; }
public DateTime CreatedAt { get; set; }
}
定义好实体类后，接下来需要创建数据库上下文类。上下文类是应用程序与数据库之间的桥梁，负责管理实体对象的生命周期、跟踪状态变更并执行数据库操作。上下文类必须继承自Microsoft.EntityFrameworkCore命名空间下的DbContext类，并通过DbSet属性暴露需要映射的实体集合。
public class BloggingContext : DbContext
{
public BloggingContext(DbContextOptions<BloggingContext> options) : base(options)
{
}
public DbSet<BlogPost> BlogPosts { get; set; }
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
// 使用Fluent API进行更精细的配置
modelBuilder.Entity<BlogPost>()
.Property(b => b.Title)
.IsRequired()
.HasMaxLength(200);
modelBuilder.Entity<BlogPost>()
.Property(b => b.CreatedAt)
.HasDefaultValueSql("GETDATE()");
}
}
在上述代码中，我们不仅定义了DbSet属性，还重写了OnModelCreating方法。这是Code First中非常关键的一环，通过Fluent API，我们可以配置主键生成策略、字段长度、是否可空以及默认值等。相比于在实体类上直接使用数据注解（如[Required]），Fluent API提供了更强大的功能和更好的可维护性，保持了实体类的纯净性。
掌握数据库迁移与数据播种
实体类和上下文类准备就绪后，如何将它们转化为真实的数据库表呢？这就需要引入迁移机制。迁移是Code First管理数据库架构演进的解决方案，它记录了从初始版本到当前版本的所有数据库变更脚本。通过NuGet包管理器控制台或.NET CLI，开发者可以轻松生成和应用迁移。
首先，我们需要安装Microsoft.EntityFrameworkCore.Tools工具包。然后在包管理器控制台中执行Add-Migration InitialCreate命令。EF Core会自动对比当前实体类与上一次迁移的快照，生成包含创建表、列和约束等操作的C#代码文件。检查无误后，执行Update-Database命令，框架就会连接到配置好的数据库并执行生成的脚本，完成物理表的创建。
除了创建表结构，Code First还支持数据播种功能。在应用程序首次启动或数据库初始化时，我们往往需要插入一些基础配置数据。通过在上下文类的OnModelCreating方法中调用HasData方法，可以定义初始数据。当执行迁移时，这些数据会被自动写入对应的表中。
modelBuilder.Entity<BlogPost>().HasData(
new BlogPost { Id = 1, Title = "第一篇文章", Content = "这是测试内容", CreatedAt = new DateTime(2023, 1, 1) }
);
数据播种机制极大地简化了环境部署的复杂度。无论是开发环境、测试环境还是生产环境，只要应用了迁移，基础数据就能保持一致。需要注意的是，HasData指定的主键值必须是固定的，因为EF Core通过主键来判断数据是否需要更新。如果后续修改了HasData中的数据内容，再次生成迁移时，框架会自动生成UPDATE语句，确保数据库中的数据与代码定义保持同步。
EF CoreCode First数据库迁移修改时间：2026-08-25 03:48:59