EF Core 生成迁移脚本主要用 dotnet ef migrations script 命令:IDL 脚本通过 --from 0 从空库生成全量建表脚本;幂等脚本加 --idempotent 实现重复执行安全,结合 --from 0 可得全量幂等脚本,适配生产部署。

EF Core 生成迁移脚本(包括 IDL 脚本和幂等脚本)主要通过 dotnet ef migrations script 命令实现,关键在于参数组合与上下文状态。IDL(Initial Database Language)脚本通常指从空数据库开始、应用全部迁移的完整建库脚本;幂等脚本则确保多次执行不报错,适合生产环境部署。
生成完整初始建库脚本(IDL 风格)
所谓“IDL 脚本”,虽非 EF Core 官方术语,但常被理解为:从空数据库出发,一次性执行所有已存在迁移,生成包含 CREATE DATABASE(若支持)、CREATE TABLE、INSERT INTO __EFMigrationsHistory 等的完整 SQL 脚本。
推荐做法是显式指定起点为空(--from 0),终点为最新迁移:
-
命令示例:
dotnet ef migrations script --from 0 --to [LatestMigrationName] --output idl-script.sql - 省略
--to参数时,默认取最新迁移名,可简写为:dotnet ef migrations script --from 0 --output idl-script.sql - 该脚本不含数据库创建语句(如
CREATE DATABASE),因 EF Core 默认不管理数据库生命周期;如需,需手动添加或用自定义脚本封装
生成幂等迁移脚本(Idempotent Script)
幂等脚本的核心是:每条迁移操作前自动检查是否已执行(通过查询 __EFMigrationsHistory 表),跳过已存在的迁移。这样无论目标库处于哪个迁移版本,执行该脚本都安全。
启用幂等模式只需加 --idempotent 参数:
-
基础命令:
dotnet ef migrations script --idempotent --output idempotent.sql - 它默认从当前数据库状态迁移到最新版(即“增量更新”)。若想覆盖全量(从空到最新),仍需配合
--from 0:dotnet ef migrations script --idempotent --from 0 --output full-idempotent.sql - 注意:幂等脚本中所有 DDL/DML 都包裹在
IF NOT EXISTS或条件判断块中(SQL Server 使用IF NOT EXISTS (SELECT ...)),因此可重复运行
实用技巧与注意事项
-
确保迁移已生成:运行脚本前,先执行
dotnet ef migrations add Xxx确保Migrations/目录下有对应快照和迁移类 -
指定 DbContext 类型:若项目含多个
DbContext,需用--context MyDbContext明确指定 -
连接字符串影响输出:EF Core 根据当前
DbContext的OnConfiguring或运行时注入的连接字符串,决定生成目标数据库方言(如 SQL Server / PostgreSQL),脚本语法会随之变化 -
不依赖运行时数据库状态:
script命令仅读取迁移文件和模型快照,不连接真实数据库(除非你用了--no-build且设计时服务异常)
基本上就这些。IDL 风格重在“从零开始”,幂等脚本重在“安全复用”。两者结合(--idempotent --from 0)最接近生产发布需求。










