Mapster：高效、有趣的对象映射工具

### 如何在 C# 中使用 Mapster 进行对象映射 #### 安装 Mapster 库 为了在项目中使用 Mapster，首先需要将其安装到您的解决方案中。可以通过 NuGet 包管理器完成此操作[^1]。 运行以下命令以安装 Mapster： ```bash Install-Package Mapster ``` 或者，在 Visual Studio 的包管理器控制台中执行相同的操作。 --- #### 基本的对象映射功能 Mapster 是一个轻量级且高效的对象映射工具，能够自动将源对象中的属性值复制到目标对象中[^2]。以下是基本的用法： 定义两个类 `Source` 和 `Destination` 来演示简单的对象映射过程： ```csharp public class Source { public int Id { get; set; } public string Name { get; set; } } public class Destination { public int Id { get; set; } public string FullName { get; set; } // 注意这里的目标字段名不同 } ``` 创建并初始化一个 `Source` 类实例，并将其转换为目标类型的实例： ```csharp var source = new Source { Id = 1, Name = "John Doe" }; // 执行映射 var destination = source.Adapt<Destination>(); Console.WriteLine($"Id: {destination.Id}, FullName: {destination.FullName}"); ``` 上述代码会尝试匹配同名属性并将它们赋值给目标对象。如果名称不一致，则可以自定义映射逻辑[^3]。 --- #### 配置复杂映射关系 当遇到更复杂的场景时（例如字段重命名、数据转换等），可以利用 `TypeAdapterConfig<TSrc, TDest>` 静态泛型方法来自定义映射规则。 下面的例子展示了如何手动指定字段间的映射规则： ```csharp using Mapster; TypeAdapterConfig<Source, Destination> .NewConfig() .Map(dest => dest.FullName, src => $"{src.Name}_Mapped"); var customMappedResult = source.Adapt<Destination>(); Console.WriteLine(customMappedResult.FullName); // 输出 John Doe_Mapped ``` 通过这种方式，您可以灵活地调整任意字段的行为或格式化其输出。 --- #### 性能优化与批量映射 除了单个对象之间的映射外，Mapster 支持集合类型的数据转换。假设有一个列表需要被映射成另一个结构化的集合形式，可以直接调用 `.Adapt<List<TDest>>()` 方法实现这一需求。 示例代码如下所示： ```csharp List<Source> sources = new List<Source>() { new Source { Id = 1, Name = "Alice" }, new Source { Id = 2, Name = "Bob" } }; List<Destination> destinations = sources.Adapt<List<Destination>>(); foreach (var item in destinations) { Console.WriteLine(item.FullName); } ``` 这种机制非常适合处理大量实体模型间的一致性同步工作流。 --- #### 自动注册依赖注入支持 如果您正在构建基于 ASP.NET Core 的应用程序，还可以让 Mapster 更加无缝集成至 DI 容器之中。只需引入扩展包 `Mapster.Extensions.Microsoft.DependencyInjection` 并按照官方文档指引设置即可启用全局扫描适配能力。 ---