Dapper 查询数据的核心是 Query 方法家族，直接执行 SQL 并映射为对象；支持多行（Query）、单行（QueryFirstOrDefault 等）、动态/匿名查询，以及缓冲控制和 IN 参数等进阶技巧。
Dapper 查询数据的核心就是 Query 方法家族，它不搞抽象封装，直接让你写 SQL，再把结果映射成对象。用法简单，但细节决定是否健壮、安全、高效。
基础查询：Query 返回多行
这是最常用的查询方式，适合查列表、分页、批量数据。
- 必须指定泛型类型
T（如User、Product），Dapper 会按属性名自动匹配列名（大小写不敏感） - SQL 中用
@参数名占位，传参用匿名对象或实体对象，天然防 SQL 注入 - 返回
IEnumerable，支持延迟执行；调用.ToList()才真正取数
示例：
string sql = "SELECT Id, Name, Email FROM Users WHERE Age > @Age AND Status = @Status"; var users = connection.Query(sql, new { Age = 18, Status = "Active" }).ToList();
单行查询：选对方法很关键
不同场景要选不同方法，它们对“无结果”或“多结果”的处理逻辑完全不同：
-
QueryFirstOrDefault：有就返回第一条，没有就返回() default(T)（null 或 0）——最常用 -
QueryFirst：必须至少有一行，否则抛异常() -
QuerySingle：必须且仅有一行，否则抛异常（适合主键精确查询）() -
QuerySingleOrDefault：最多一行，有就返回，没就 null，多于一行则抛异常()
示例：
var user = connection.QueryFirstOrDefault("SELECT * FROM Users WHERE Id = @Id", new { Id = 123 });
动态与匿名查询：不用定义类也能查
临时查、调试、导出、字段不确定时，可用 dynamic 或匿名类型：
- 不带泛型的
Query()返回IEnumerable，每行是 ExpandoObject，可按列名访问：row.Name、row.Email - 也可用
new { }匿名对象接收单行：var result = connection.Query("SELECT COUNT(*) c FROM Users").FirstOrDefault();→ 得到 dynamic 对象，再取result.c
示例（查统计）：
var countObj = connection.Query("SELECT COUNT(*) AS Total FROM Orders").FirstOrDefault();
int total = countObj?.Total ?? 0;进阶技巧：缓冲控制与 IN 查询
大数据量或特殊场景下，几个实用细节：
- 加
buffered: false可启用非缓冲查询，适合逐行流式处理（避免内存爆满）：connection.Query(sql, buffered: false) - IN 条件直接传数组，Dapper 自动展开：
WHERE Id IN @ids+new { ids = new[] { 1, 2, 3 } } - 空值参数也支持：
WHERE (@Name IS NULL OR Name LIKE @Name)，传new { Name = (string)null }即可
示例（IN 查询）：
string sql = "SELECT * FROM Products WHERE CategoryId IN @categoryIds"; var products = connection.Query(sql, new { categoryIds = new[] { 1, 5, 8 } }).ToList();
基本上就这些。Dapper 的 Query 不复杂，但容易忽略参数安全、空值处理和缓冲策略这些细节。写 SQL 时保持简洁，映射时注意命名一致，再配合适当的方法选择，就能稳稳查出你要的数据。
