17370845950

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）最接近生产发布需求。