ef core code first迁移通过c#实体类和dbcontext生成并更新数据库结构,核心是add-migration创建差异化迁移文件、update-database应用变更,需注意数据丢失风险、快照维护及生产环境使用sql脚本。

EF Core 的 Code First 迁移,核心是通过 C# 类(实体类 + DbContext)生成数据库结构,并支持后续迭代更新。关键在于用命令行工具管理迁移快照和应用变更,而不是手动写 SQL。
创建初始迁移
项目中定义好实体类和继承 DbContext 的上下文类后,在包管理器控制台(PMC)或.NET CLI中执行:
- PMC: Add-Migration InitialCreate
- CLI: dotnet ef migrations add InitialCreate
这会生成一个迁移类(含 Up/Down 方法)和一个快照文件(ModelSnapshot),记录当前模型状态。
应用迁移到数据库
生成迁移后,需将其实际作用于数据库:
- PMC: Update-Database
- CLI: dotnet ef database update
默认应用所有待处理迁移;也可指定迁移名(如 Update-Database InitialCreate)来控制边界。
后续模型变更与增量迁移
修改实体类(如加字段、改类型、新增关系)后,只需再执行一次 Add-Migration,EF Core 会比对最新模型和快照,自动生成差异化的 Up/Down 逻辑。例如:
- 给
Blog类加了Rating属性 → 新迁移里只包含ALTER TABLE或ADD COLUMN - 删除一个实体 → 迁移中会包含
DROP TABLE和对应关系清理
记得每次改完模型都重新生成并应用迁移,避免模型与库结构脱节。
常见注意事项
迁移不是万能的全自动方案:
-
数据丢失风险:重命名列、改类型(如 string → int)、删非空字段等操作,EF Core 默认不保留数据,需手动在
Up方法中补 SQL 或使用Sql()方法 - 快照要提交进代码库:它是迁移链的“基准”,缺失会导致后续迁移失败
-
生产环境慎用
Update-Database:推荐导出 SQL 脚本(Script-Migration/dotnet ef migrations script)人工审核后再执行 -
多个开发者协作时:拉取新迁移后,先运行
Update-Database再改模型,避免生成冲突迁移
基本上就这些。掌握 Add-Migration + Update-Database 这两个动作,配合理解迁移文件里的生成逻辑,Code First 迁移就能稳稳落地。










