如何使用EF Core Code First实现数据库迁移？

本文共计674个文字，预计阅读时间需要3分钟。

EF Core 的 Code First 迁移，核心是通过 C# 编写迁移代码来实现数据库的变更。

创建初始迁移

项目中定义好实体类和继承 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 迁移就能稳稳落地。