17370845950

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

EF Core 生成数据库脚本，最常用、最可控的方式就是用 Script-Migration 命令。它不直接操作数据库，而是输出 SQL 脚本，适合审核、部署或离线环境使用。

基本用法：生成完整建库脚本（从空库到最新）

在 Package Manager Console（PMC）中运行：

这会生成从“初始空状态”（即没有迁移）到当前最新迁移的完整 SQL 脚本，包含 CREATE TABLE、约束、索引等，相当于“一键建库”。适合首次部署。

生成增量脚本（两个版本之间）

指定起始和目标迁移名，生成中间变更 SQL：

注意：
- 迁移名是类名（如 20251001000000_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 流程。