一篇搞定 dotnet ef：EF Core 常用命令与实战指南

基础知识

要想执行任何dotnet ef命令，都得先在csproj中把Microsoft.EntityFrameworkCore.Design包给包含进去。

命令总览

常用命令详解 + 示例

创建迁移

dotnet ef migrations add InitialCreate

在 Migrations/ 目录下生成：

• YYYYMMDDHHMMSS_InitialCreate.cs：迁移代码

• AppDbContextModelSnapshot.cs：模型快照文件

常用参数：

在多项目架构，比如分离 DAL/启动项目的架构中，有一点务必牢记，那就是必须同时指定 --project 和 --startup-project。这是为什么呢？原因就在于，项目，也就是我们常说的目标项目，它是命令添加或删除文件的位置。默认情况下，当前目录中的项目就是目标项目，但我们可以通过 --project 选项来指定另一个项目作为目标项目。而启动项目呢，它是工具生成并运行的项目，这些工具必须在设计时执行应用程序代码，才能获取项目的相关信息，像数据库连接字符串以及模型的配置等。默认情况下，当前目录中的项目也是启动项目，同样地，我们也能够使用 --startup-project 选项来将另一个项目指定为启动项目。启动项目和目标项目一般是同一个项目，但在某些场景下，它们也可能是单独的项目，比如EF Core上下文和实体类位于.NET类库中，而.NET控制台应用或Web应用引用了这个类库，或者将迁移代码放置在独立于EF Core上下文的类库中。所以，在多项目架构中，同时指定这两个参数是必不可少的哦。

应用迁移

dotnet ef database update

• 将数据库更新到最新迁移。

• 如果数据库不存在，会自动创建。

可指定版本：

dotnet ef database update InitialCreate

将数据库回滚到指定迁移（或升级到某个中间版本）。

查看迁移

dotnet ef migrations list

输出：

20250922121212_InitialCreate
20250923104530_AddUserTable

删除迁移

dotnet ef migrations remove

• 删除最新迁移文件。

• 仅限未执行 database update 的迁移。

生成 SQL 脚本

dotnet ef migrations script

• 生成从初始数据库到最新迁移的 SQL 脚本。

• 可指定起止迁移：

dotnet ef migrations script InitialCreate AddUserTable -o update.sql

删除数据库

dotnet ef database drop

• 交互式确认后删除数据库。

• 可加 --force 跳过确认。

查看 DbContext 信息

dotnet ef dbcontext info

输出数据库提供程序、连接字符串等信息。

列出 DbContext

dotnet ef dbcontext list

用于多上下文项目，可快速确认可用的 DbContext。

数据库逆向生成实体 (Database First)

dotnet ef dbcontext scaffold 
"Server=localhost;Database=MyDb;User Id=sa;Password=Passw0rd;" 
Microsoft.EntityFrameworkCore.SqlServer 
--output-dir Models --context MyDbContext

常用参数：

模型预编译优化

EF Core 6+ 提供：

dotnet ef dbcontext optimize

• 在编译时预生成模型元数据，提升启动速度。

• 适合大型数据库或高性能场景。

开发常用流程示例

Code First 开发流程

# 1. 添加初始迁移
dotnet ef migrations add InitialCreate

# 2. 创建/更新数据库
dotnet ef database update

# 3. 修改实体模型后生成新迁移
dotnet ef migrations add AddUserTable

# 4. 应用到数据库
dotnet ef database update

Database First 开发流程

# 从现有数据库生成实体与上下文
dotnet ef dbcontext scaffold 
"Server=localhost;Database=MyDb;User Id=sa;Password=Passw0rd;" 
Microsoft.EntityFrameworkCore.SqlServer 
--output-dir Models

常见问题与技巧

总结