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
推荐方式(依赖注入 + appsettings.json):
// Startup.cs 或 Program.cs(.NET 6+)
builder.Services.AddDbContext<AppDbContext>(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 的第一步。










