C# EF Core入门：Code First实战教程

Code First模式通过C#类定义数据表结构，EF Core自动创建和更新数据库。每个public class对应一张表，public property对应字段，Id或ClassNameId等命名的int/long属性被推断为主键并自增；字符串默认映射为nvarchar(max)，可使用[StringLength]或Fluent API限制长度。GUID主键需配合ValueGeneratedOnAdd()配置。通过继承DbContext并声明DbSet属性映射实体，推荐使用依赖注入方式配置连接字符串。关系通过导航属性和外键定义，EF自动建立约束。迁移（Migration）是核心机制：执行dotnet ef migrations add生成快照，dotnet ef database update应用变更，支持回滚与SQL脚本导出供审核。增删改查通过DbContext和DbSet进行，操作基于LINQ实现延迟执行，SaveChangesAsync()触发实际SQL。关联查询应使用Include避免N+1问题。该模式将数据库结构纳入代码版本控制，适用于快速迭代与团队协作，关键是管理好实体、迁移和查询逻辑。

用 Code First 模式开发，你不用先建数据库，而是从 C# 类（实体）出发，让 EF Core 自动创建和更新数据库结构——适合快速迭代、团队协作和版本可控的开发场景。

定义实体类，就是定义数据表

每个 public class 对应一张表，每个 public property 对应一个字段。EF Core 会按约定推断主键（如叫 Id 或 ClassNameId 的 int/long 属性），非空引用类型默认为必填字段。

例如：

public class Product
{
    public int Id { get; set; }
    public string Name { get; set; } = string.Empty; // EF Core 6+ 要求非空属性设默认值或标记为可空
    public decimal Price { get; set; }
    public DateTime CreatedAt { get; set; } = DateTime.UtcNow;
}

• 不加额外配置时，Id 会被识别为主键，并启用自增（SQL Server）或 AUTOINCREMENT（SQLite）
• 若想用 GUID 主键，写 public Guid Id { get; set; } = Guid.NewGuid();，再在 DbContext 中配置 ValueGeneratedOnAdd()
• 字符串属性默认映射为 nvarchar(max)，可用 [StringLength(100)] 或 Fluent API 限制长度

配置 DbContext，连接实体与数据库

继承 DbContext，声明 DbSet 属性表示每张表，并重写 OnConfiguring 或使用依赖注入传入连接字符串。

推荐方式（依赖注入 + appsettings.json）：

// Startup.cs 或 Program.cs（.NET 6+）
builder.Services.AddDbContext(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection")));// SQL Server 示例

• AppDbContext 中只需写 public DbSet Products { get; set; }，EF 就知道这张表叫 Products
• 若表名不想用复数（如要叫 Product 而非 Products），可在 OnModelCreating 里用 entity.ToTable("Product")
• 关系（如 Product ↔ Category）通过导航属性 + 外键属性定义，EF 会自动识别并建外键约束

生成并执行迁移（Migration），把代码变更转成数据库操作

迁移是 Code First 的核心机制：它把你的实体改动“快照”下来，生成可回滚的 SQL 脚本。

• 第一次建库：运行 dotnet ef migrations add InitialCreate → 生成迁移文件
• 应用到数据库：运行 dotnet ef database update → 创建库和表
• 后续改了实体（比如加了个 Description 字段）：再执行 dotnet ef migrations add AddProductDescription，然后 update
• 误操作？用 dotnet ef database rollback（EF Core 8+）或删掉最后的迁移再 update 回退

注意：生产环境慎用 update 直接上线；建议导出 SQL（dotnet ef migrations script）交 DBA 审核。

用起来：增删改查就和操作对象一样自然

DbContext 实例是工作单元（Unit of Work），DbSet 是查询入口。所有操作都走 LINQ，最终才触发 SQL。

using var context = new AppDbContext();
var product = new Product { Name = "无线耳机", Price = 299.0m };
context.Products.Add(product);
await context.SaveChangesAsync(); // 真正写入数据库

• 查数据：context.Products.Where(p => p.Price > 200).ToList() —— 延迟执行，不调 ToList() 不发 SQL
• 改数据：var p = await context.Products.FindAsync(1); p.Price = 349; await context.SaveChangesAsync();
• 删数据：context.Products.Remove(p); 或 context.Products.RemoveRange(list);
• 避免 N+1：关联查询用 Include(x => x.Category) 预加载，而不是循环中访问导航属性

基本上就这些。Code First 不是“不关心数据库”，而是把数据库结构当成代码的一部分来管理——写好实体、跑好迁移、查得清楚，你就已经踩稳了 EF Core 的第一步。