如何在Entity Framework Core中生成空的迁移文件？

操作前请先确认当前DbContext的所有待生效结构变更已经完成迁移，避免自动生成的迁移文件附带结构变更逻辑。

生成空迁移的命令 #

• 包管理器控制台（PMC，Visual Studio内置）执行命令：
  Add-Migration <自定义迁移名称> [-Context <你的DbContext类名>]

方括号内为可选参数，项目内只有一个DbContext时可以省略。

• .NET CLI 执行命令：
  dotnet ef migrations add <自定义迁移名称> [--context <你的DbContext类名>]

写入数据变更SQL #

执行命令后会自动生成对应名称的空迁移文件，文件中默认Up、Down方法均为空，你可以直接在对应方法中调用migrationBuilder.Sql()方法写入需要执行的SQL语句：

// 示例：批量更新用户状态的迁移逻辑
public partial class BatchUpdateUserActiveStatus : Migration
{
    protected override void Up(MigrationBuilder migrationBuilder)
    {
        // 迁移正向执行时运行的SQL
        migrationBuilder.Sql("UPDATE Users SET IsEnabled = 1 WHERE RegisterTime < '2024-01-01';");
    }

    protected override void Down(MigrationBuilder migrationBuilder)
    {
        // 迁移回滚时运行的SQL，无需回滚可留空
        migrationBuilder.Sql("UPDATE Users SET IsEnabled = 0 WHERE RegisterTime < '2024-01-01';");
    }
}

注意事项 #

• 每次生成迁移后务必检查生成的代码，确认没有自动生成的结构变更语句，避免误操作数据库结构
• 涉及数据修改的SQL建议先在测试环境验证执行效果，再部署到生产环境
• 如果需要针对不同环境执行差异化SQL，可以在迁移逻辑中读取环境变量判断运行环境，执行对应语句

内容的提问来源于stack exchange，提问作者Emmanuel DURIN