AutoMapper中CreateMap与CreateProjection的区别及使用场景咨询

核心区别：CreateMap vs CreateProjection #

• CreateMap：AutoMapper最基础的映射配置，用于内存对象间的转换。它支持完整的映射规则，包括复杂嵌套、自定义转换逻辑（如ConvertUsing）、值解析器等。当数据已从数据库加载到内存（比如EF Core执行ToList()后），要把实体转成DTO时，用这个配置配合MapTo/Map方法。
  示例：

  // 配置
  CreateMap<Product, ProductDto>();
  // 内存对象转换
  var productDto = product.MapTo<ProductDto>();
  // 或者
  var productDto = mapper.Map<ProductDto>(product);
  

• CreateProjection：专为LINQ查询投影设计的配置，只会生成数据库可执行的投影表达式，不处理内存对象转换。它的规则更受限，不能用依赖内存状态的转换逻辑（比如需要访问其他内存对象的解析器），因为最终会被EF Core翻译成SQL在数据库端执行。
  示例：

  // 配置
  CreateProjection<Product, ProductDto>();
  // LINQ查询中直接投影
  var productDtos = dbContext.Products.ProjectTo<ProductDto>(mapper.ConfigurationProvider).ToList();
  

关联关系：配置与执行方法的匹配 #

• CreateMap 对应 Map/MapTo：Map系列方法是内存对象转换，必须基于CreateMap的配置，因为它要处理内存中对象的所有字段映射、自定义逻辑。
• CreateProjection 对应 ProjectTo：ProjectTo是LINQ查询的扩展方法，基于CreateProjection的配置（CreateMap也可兼容，但CreateProjection更精准），会把映射规则转换成EF Core能理解的SQL，只查询需要的字段，减少数据库返回的数据量。

何时选择哪种方案？ #

1. 从数据库直接获取DTO集合/单个对象：用CreateProjection + ProjectTo。这是EF Core场景的最佳实践，能规避SELECT N+1问题，只查询DTO需要的字段，性能更优。比如Blazor Server加载列表数据时，直接在DbSet上用ProjectTo，无需先加载实体再转换。

2. 对象已在内存中（如缓存获取、修改实体后转DTO）：用CreateMap + Map/MapTo。比如从数据库加载Product实体并修改属性后，再转成ProductDto返回前端，这时候用Map更合适。

3. 兼容场景：CreateMap的配置也能被ProjectTo使用，AutoMapper会自动把规则转换成投影表达式（只要规则符合EF Core的SQL转换要求）。但如果映射规则里有无法被SQL转换的逻辑（比如自定义内存值解析器），ProjectTo会报错，而CreateProjection会强制你只配置可投影的规则，避免这类问题。

Blazor Server与EF Core额外提示 #

你关注的AutoMapper.Collection和AutoMapper.Collection.EFCore是用来处理集合增量更新的（比如对比前端传来的DTO集合与数据库实体集合，自动生成Add/Update/Delete操作），等你掌握基础映射后再学习完全没问题。Blazor Server是服务器端运行，内存转换和查询投影的性能差异更明显，所以尽量用ProjectTo处理数据库查询场景，减少内存占用和数据库传输量。

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