Script-Migration 是 EF Core 生成数据库脚本最常用、最可控的方式,输出 SQL 脚本供审核、部署或离线使用;支持从空库建库(-From 0)、增量变更(-From/-To)、幂等执行(-Idempotent)、文件输出(-Output)及多 DbContext 指定(-Context)。

EF Core 生成数据库脚本,最常用、最可控的方式就是用 Script-Migration 命令。它不直接操作数据库,而是输出 SQL 脚本,适合审核、部署或离线环境使用。
基本用法:生成完整建库脚本(从空库到最新)
在 Package Manager Console(PMC)中运行:
Script-Migration -From 0
这会生成从“初始空状态”(即没有迁移)到当前最新迁移的完整 SQL 脚本,包含 CREATE TABLE、约束、索引等,相当于“一键建库”。适合首次部署。
生成增量脚本(两个版本之间)
指定起始和目标迁移名,生成中间变更 SQL:
Script-Migration -From InitialCreate -To AddUserEmail
注意:
- 迁移名是类名(如 20231001000000_InitialCreate),可只写后缀部分(如 InitialCreate);
- -From 和 -To 都支持迁移名或 0(表示空库);
- 若省略 -To,默认为最新迁移。
常用参数与实用技巧
-
-Idempotent:生成带存在性检查的脚本(如
IF NOT EXISTS),避免重复执行报错,上线部署推荐加上 -
-Output:直接保存到文件,例如:
Script-Migration -From 0 -Idempotent -Output "deploy.sql" - -Context:指定 DbContext 类型名(多个 DbContext 时必须用)
- -Project / -StartupProject:跨项目时明确指定迁移项目和启动项目
注意事项
- 确保已运行
Add-Migration创建好迁移类,否则脚本可能不全 - 脚本基于当前模型和迁移历史生成,务必先提交所有待部署的迁移
- SQL Server 默认生成 T-SQL;SQLite/PostgreSQL 等提供方会生成对应方言,但部分高级特性(如自定义函数)可能不被自动翻译
- 生成的脚本不含
INSERT初始数据(除非你在Up(MigrationBuilder)中手动写了Sql())
基本上就这些。用好 Script-Migration,能让你的数据库变更更透明、更可控,也更容易融入 CI/CD 流程。










