ABP VNext + Mapster：高性能对象映射

ABP VNext + Mapster：高性能对象映射 🚀🎉

---

---

1. 引言 ✨

✨ TL;DR

• 🔄 用 Mapster 取代 AutoMapper，实现亚微秒级 (<1 µs) 的对象映射速度
• ⚡️ 借助编译时代码生成与缓存，彻底消除运行时反射与表达式树开销
• 🔗 与 ABP VNext 9.2 的模块化、依赖注入深度集成

📚 背景与动机

• ⏱ 性能瓶颈：在大型分层微服务中，DTO↔实体映射极其频繁，可能成为吞吐与延迟的痛点。
• 🛑 AutoMapper 局限：运行时通过反射与表达式树构建映射器，冷启动慢，内存与 GC 压力大。
• 🚀 Mapster 优势：支持 Roslyn 源码生成（CodeGen）与映射缓存（FEC），高 QPS 场景几乎零运行时开销。

---

2. 环境与依赖 🛠

• 平台版本：

  • .NET SDK 9
  • ABP Framework VNext 9.2 final（2025-06-02 发布）
  • ABP Framework VNext 9.2.3 补丁（2025-07-23 发布）

• 核心 NuGet 包：

  • Mapster

  • Mapster.DependencyInjection

  • Mapster.Tool

    • 稳定版 8.4.0（2023-09-21）
    • 预览版 8.4.2-pre02（2025-01-13）

---

3. 快速上手：零配置 ⚡️

1. 安装 Mapster.Tool

   # 本地安装（推荐 CI/CD）
   dotnet new tool-manifest
   dotnet tool install --local Mapster.Tool --version 8.4.0
   dotnet tool run mapster init
   dotnet tool run mapster generate
   
   # 或全局安装
   dotnet tool install --global Mapster.Tool --version 8.4.0
   mapster init
   mapster generate
   

2. 在 ABP 模块中注册

   public override void ConfigureServices(ServiceConfigurationContext context)
   {
        
        
       // 注册 TypeAdapterConfig 单例、ServiceMapper（IMapper 实现）为 Scoped，并扫描所有 IRegister
       context.Services.AddMapster();
   }
   

3. 启动时务必调用

   // Program.cs 或任一 ABP 模块的 OnApplicationInitialization
   AdaptConfig.Register();  // ❗️ 使用编译生成的映射配置
   

4. 基础映射调用

   // 单个对象
   var dto  = entity.Adapt<MyDto>();
   // 列表批量
   var dtos = entities.Adapt<List<MyDto>>();
   

---

4. 编译时代码生成：彻底消除反射 🔧