Dapper 支持 Query() 直接返回动态对象，自动映射为 ExpandoObject，可通过列名或别名访问字段；适用于不确定结构场景，但无编译检查，需防 Null 和拼写错误，正式项目建议优先使用强类型。
Dapper 支持直接查询返回 dynamic 类型，无需提前定义实体类，适合快速获取不确定结构或临时数据的场景。核心是使用 Query 方法，Dapper 会自动将每行结果映射为 IDictionary 的动态包装对象（实际是 ExpandoObject），可通过属性名直接访问字段。
基本用法：Query 查询单表
最常用方式是调用 connection.Query，SQL 返回的每一列都会变成 dynamic 对象的一个属性：
- 字段名不区分大小写（但建议保持 SQL 中的命名风格一致）
- NULL 值会映射为
null（对应 C# 的null，不是字符串 “null”） - 支持别名（
SELECT Name AS UserName→ 可用item.UserName访问）
示例：
var sql = "SELECT Id, Name, Email FROM Users WHERE Status = @status";
var users = connection.Query(sql, new { status = "Active" }).ToList();
foreach (var u in users)
{
Console.WriteLine($"{u.Id} - {u.Name} "); // 属性名直接来自列名或别名
}
处理多表 JOIN 或匿名结构
即使 SQL 包含 JOIN、计算列、函数结果（如 COUNT(*)、GETDATE()），只要列有明确名称（推荐用别名），dynamic 就能正常访问：
- 避免无名字段，比如
SELECT COUNT(*)应写成SELECT COUNT(*) AS Total - JOIN 后同名列需显式别名，否则后一个会覆盖前一个（如
u.Id AS UserId, o.Id AS OrderId） - 动态对象属性访问是运行时绑定，拼写错误会在运行时报
RuntimeBinderException
示例：
var sql = @"
SELECT u.Name, COUNT(o.Id) AS OrderCount
FROM Users u
LEFT JOIN Orders o ON u.Id = o.UserId
GROUP BY u.Id, u.Name";
var result = connection.Query(sql).ToList();
foreach (var r in result)
{
Console.WriteLine($"{r.Name} has {r.OrderCount} orders");
}
安全访问 dynamic 字段（防 Null 和拼写错误）
dynamic 没有编译期检查，建议加一层防护：
- 用
TryGetMember或转换为IDictionary再判断 key 存在性 - 访问前判空：
if (u?.Name != null) ... - 用扩展方法封装安全取值（如
u.SafeGetString("Name")） - 开发阶段可先用
var first = result.FirstOrDefault(); Console.WriteLine(first);查看实际属性名
注意：dynamic 不等于 var，也不支持 LINQ to Objects 的强类型操作
dynamic 是运行时解析，不能直接对 IEnumerable 使用 .Where(x => x.Age > 18) 这类 LINQ 表达式（会报错）；如需过滤，得转成 List 或先映射为具体类型：
- 简单过滤可用
foreach+ 手动判断 - 复杂逻辑建议改用强类型实体类 +
Query() - 如果只是投影部分字段，考虑用匿名类型
Query（但注意：Dapper 不支持直接Query，需用Query后再 Select）
基本上就这些。dynamic 查询灵活轻量，适合脚本化、配置化或原型开发，但正式项目中建议优先用强类型保障可维护性。