EF Core在应用启动时，会扫描所有实体类、配置规则，构建出完整的EF Core模型，这个过程会随着实体数量和配置复杂度的提升而变慢。编译模型（Compiled Model）就是针对这个问题的优化方案，它允许开发者在编译阶段就完成模型的编译工作，运行时直接加载编译后的结果，跳过重复的模型构建步骤。
编译模型的核心原理
EF Core的模型构建包含模型发现、配置应用、模型验证、模型编译等多个步骤，其中模型编译是将内存中的模型结构转换为可高效执行的运行时表示的过程，这一步的开销通常占比最高。编译模型会把这些步骤提前到项目编译阶段完成，生成一个包含编译后模型信息的静态类，运行时EF Core直接读取这个静态类的内容，无需再次执行完整的模型构建流程。
启用编译模型的步骤
1. 安装必要的NuGet包
首先需要安装EF Core的编译模型工具包，在项目中执行以下命令安装：
dotnet add package Microsoft.EntityFrameworkCore.Tools
2. 生成编译模型代码
在项目目录下执行EF Core的脚手架命令，生成编译模型相关的代码：
dotnet ef dbcontext optimize --output-dir Models/Compiled --namespace MyApp.Models.Compiled
命令执行完成后，会在指定的输出目录下生成两个文件：一个包含编译后模型的静态类文件，另一个是更新后的DbContext配置代码。
3. 修改DbContext配置
打开生成的DbContext配置代码，会看到OnConfiguring方法中已经添加了使用编译模型的配置，示例代码如下：
protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
if (!optionsBuilder.IsConfigured)
{
optionsBuilder.UseSqlServer("Server=127.0.0.1;Database=TestDB;Trusted_Connection=True;")
// 使用生成的编译模型
.UseModel(MyApp.Models.Compiled.CompiledModels.MyDbContextModel.Instance);
}
}
其中MyApp.Models.Compiled.CompiledModels.MyDbContextModel就是生成的编译模型静态类，Instance属性返回编译后的模型实例。
编译模型的适用场景
- 实体类数量较多，模型构建耗时明显的项目
- 对应用启动速度有较高要求的服务类应用
- 需要频繁重启的应用实例，比如容器化部署的短生命周期服务
使用注意事项
编译模型生成后，如果后续修改了实体类、或者调整了EF Core的配置规则，需要重新执行编译模型生成命令，否则运行时使用的还是旧的模型，会导致配置不生效甚至运行错误。另外编译模型目前不支持所有EF Core特性，比如部分动态模型配置场景可能无法使用，使用前需要确认项目中的EF Core用法是否兼容。
性能对比参考
以下是一个简单的性能对比示例，测试环境为10个实体类，每个实体类包含5-10个属性的场景：
| 场景 | 平均启动耗时（毫秒） |
|---|---|
| 未使用编译模型 | 320 |
| 使用编译模型 | 85 |
可以看到使用编译模型后，启动耗时降低了70%以上，优化效果非常明显。
常见问题解答
编译模型会影响运行时查询性能吗
不会，编译模型只是优化了模型构建的过程，运行时的查询、增删改操作逻辑和原来完全一致，不会对运行时性能产生负面影响。
每次修改实体都需要重新生成编译模型吗
是的，只要涉及实体结构、EF Core配置规则的修改，都需要重新执行优化命令生成新的编译模型，否则会出现模型不匹配的问题。
EF_CoreCompiled_ModelC#性能优化启动性能修改时间：2026-06-26 03:24:24