Dapper通过Multi-Mapping、QueryMultiple和字典缓存三种方式处理多表关联：一对一用Query配合splitOn和委托组装；一对多用字典去重聚合；多独立结果集用QueryMultiple一次性查询。
Dapper 本身不自动处理多表关联的嵌套对象，但通过 Multi-Mapping（多映射） 和 QueryMultiple 两种核心方式，可以干净、高效地把一个或多个结果集映射到多个 .NET 对象。关键不是“能不能”，而是选对方法——取决于你查的是一对多、一对一，还是完全无关的多结果集。
用 Query 做一对一或多对一映射
这是最常用的方式，适合主从结构清晰、且从表最多一条记录的场景（比如 Post + User、Order + Customer）。Dapper 把一行结果按指定列“切开”，前半段给第一个类型，后半段给第二个类型，再由你写委托组装。
- SQL 中字段顺序必须和泛型参数顺序一致：先 T1 字段，再 T2 字段；别名建议显式写出，避免同名列冲突
- splitOn 参数必须准确指向第二个对象的主键列名（如 "UserId" 或 "CustomerId"），不能只写 "Id" —— 如果两张表都叫 Id，不加别名就容易错位
- 委托里要主动赋值，比如
(post, user) => { post.Owner = user; return post; }，Dapper 不会自动设属性 - 关联数据可能为 NULL（如 LEFT JOIN），记得在访问前判空：
post.Owner?.Name
用字典缓存处理一对多（如文章+评论）
单行 SQL 返回多条子记录时（比如 1 篇文章带 5 条评论），Query 会生成 5 个重复的 Post 实例。正确做法是手动去重+聚合：
- 定义
Dictionary缓存已创建的 Postlookup = new() - 在映射委托中，先查字典：有则复用，无则新建并加入字典，再把当前 Comment 加入其 Comments 集合
- SQL 仍用 JOIN，但最终返回的是
IEnumerable，每个 Post 的 Comments 已填充好 - 注意：子对象主键列（如 CommentId）也要在 splitOn 中明确，否则 Dapper 不知道从哪开始读 Comment
用 QueryMultiple 一次查多个独立结果集
当你要查的数据彼此无关（比如同时加载用户列表 + 订单统计 + 配置项），或一对多关系太复杂不适合单 SQL JOIN 时，QueryMultiple 更稳：
- SQL 写成用分号隔开的多语句：
"SELECT * FROM Users; SELECT COUNT(*) FROM Orders; SELECT * FROM Configs" - 调用
var multi = connection.QueryMultiple(sql)，然后依次multi.Read、() multi.ReadSingle、() multi.Read() - 数据库只走一次往返，性能比多次 Query 好，也避免了 JOIN 导致的数据膨胀
- 适合报表页、后台首页等需要聚合多种数据的场景
基本上就这些。没有银弹，一对一用 Multi-Mapping，一对多靠字典缓存，多结果集用 QueryMultiple——选对路子，映射就不卡壳。
