如何让dotnet ef migrations add仅在有变更时创建迁移文件？

好问题！我之前也被这个问题烦过——有时候不小心手滑跑了dotnet ef migrations add命令，但其实实体或上下文根本没改，结果生成一堆空的迁移文件，清理起来特别麻烦。下面分享两种实用的解决思路：

一、提前检测是否有迁移变更 #

EF Core从.NET 6开始支持--dry-run（简写-d）参数，这个参数能帮你提前预览迁移内容，而不会实际生成文件。

使用--dry-run预览迁移 #

执行命令：

dotnet ef migrations add {MigrationName} --dry-run

它会模拟迁移生成的全过程，把Up和Down方法的代码打印到控制台。如果输出里两个方法都是空的（只有一对大括号），说明当前没有任何需要迁移的变更，直接跳过真正的add命令就行。

用脚本自动检测（推荐） #

如果不想每次手动检查，可以写个简单的脚本自动判断。比如下面这个PowerShell脚本：

# 替换成你要创建的迁移名称
$migrationName = "YourMigrationName"

# 执行dry-run获取预览内容
$dryRunResult = dotnet ef migrations add $migrationName --dry-run

# 检查是否是空迁移（匹配空的Up和Down方法）
$isEmptyMigration = $dryRunResult -match 'protected override void Up\(MigrationBuilder migrationBuilder\)\s+\{\s+\}' -and 
                    $dryRunResult -match 'protected override void Down\(MigrationBuilder migrationBuilder\)\s+\{\s+\}'

if ($isEmptyMigration) {
    Write-Host "⚠️  没有检测到实体/上下文变更，跳过迁移创建。"
} else {
    Write-Host "✅  检测到变更，开始创建迁移..."
    dotnet ef migrations add $migrationName
    Write-Host "迁移 $migrationName 创建完成！"
}

把这个脚本存成Add-Migration.ps1，每次需要创建迁移时运行它就行。

二、自动清理空迁移文件 #

如果不想提前检测，也可以在执行add命令后自动检查并删除空迁移文件。比如下面这个Bash脚本：

# 替换成你的迁移名称
MIGRATION_NAME="YourMigrationName"

# 执行迁移创建命令
dotnet ef migrations add $MIGRATION_NAME

# 找到最新生成的迁移主文件
LATEST_MIGRATION=$(find Migrations -name "*$MIGRATION_NAME*.cs" | sort -r | head -n 1)

# 检查是否是空迁移
if grep -q "protected override void Up.*{}" "$LATEST_MIGRATION" && grep -q "protected override void Down.*{}" "$LATEST_MIGRATION"; then
    echo "⚠️  检测到空迁移，开始删除文件..."
    # 删除主文件、Designer文件和JSON元数据文件
    rm "$LATEST_MIGRATION"
    rm "${LATEST_MIGRATION%.cs}.Designer.cs"
    rm "${LATEST_MIGRATION%.cs}.json"
    echo "空迁移文件已删除！"
else
    echo "✅  迁移 $MIGRATION_NAME 创建成功！"
fi

这个脚本会在创建迁移后自动检查，如果是空迁移就把相关的三个文件都删掉，省心不少。

小提示 #

如果你用的是低于.NET 6的版本，--dry-run参数还没上线，那可以用dotnet ef migrations script --from <最后一个迁移名称> --to <最后一个迁移名称>来生成空脚本，判断是否有变更——如果生成的脚本里只有注释，没有实际SQL，说明没有需要迁移的内容。

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