.NET 6中如何为现有数据库生成迁移及从Database-First转Code-First同步？

前提准备 #

1. 安装EF Core CLI工具
   打开终端执行以下命令安装（或更新）全局工具：

   dotnet tool install --global dotnet-ef
   # 已安装则更新
   dotnet tool update --global dotnet-ef
   

2. 为项目添加必要NuGet包
   在项目根目录执行，替换对应的数据库Provider（以SQL Server为例）：

   dotnet add package Microsoft.EntityFrameworkCore.Design
   dotnet add package Microsoft.EntityFrameworkCore.SqlServer
   

生成迁移文件步骤 #

1. 反向生成实体类与DbContext（可选但高效）
   从现有数据库生成对应的实体类和DbContext，命令格式如下：

   dotnet ef dbcontext scaffold "你的数据库连接字符串" 数据库Provider名称 -o 实体类输出目录
   

   示例（SQL Server）：

   dotnet ef dbcontext scaffold "Server=.;Database=YourDatabase;Trusted_Connection=True;" Microsoft.EntityFrameworkCore.SqlServer -o Models
   

   这一步会自动生成匹配数据库结构的实体类和DbContext。

2. 创建初始迁移
   在项目根目录执行，生成对应当前数据库结构的初始迁移文件：

   dotnet ef migrations add InitialCreate
   

   EF Core会对比DbContext定义和数据库的实际结构，生成用于描述初始状态的迁移脚本。由于数据库已存在，此迁移仅作为后续Code-First变更的基准，无需执行database update（除非你需要确认状态一致）。

完全可以实现，核心是先通过反向生成建立代码与数据库的基准映射，后续通过Code-First的迁移机制管理变更。

具体步骤 #

1. 完成Database-First的基准建立
   按照上面的步骤，通过scaffold命令生成实体类和DbContext，并创建初始迁移InitialCreate。此时EF Core会将该迁移标记为已应用（因为数据库结构与迁移定义一致）。

2. 切换到Code-First模式管理变更

   • 修改代码：直接编辑实体类（添加字段、修改数据类型等）或在DbContext的OnModelCreating方法中配置映射规则（添加索引、外键约束等）。
   • 生成新迁移：每次代码变更后，执行命令生成对应迁移文件：

     dotnet ef migrations add 迁移名称（如AddUserEmailColumn）
     

   • 同步数据库：执行命令将迁移应用到数据库，EF Core会自动计算代码与数据库的差异并执行对应的SQL脚本：

     dotnet ef database update
     

关键注意事项 #

• 反向生成后，务必验证实体类和DbContext的映射是否准确（如主键、外键、数据类型、长度约束等），避免后续迁移出现不一致。
• 切换到Code-First后，禁止手动修改数据库结构，所有变更必须通过代码修改+迁移生成的流程完成，否则会导致EF Core的迁移追踪状态混乱。
• 如果需要调整已有数据库的结构（如添加索引），优先通过Fluent API在DbContext中配置，而非直接修改数据库，再生成迁移同步。

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