Dapper 查询数据的核心就是 Query 方法家族，它不搞抽象封装，直接让你写 SQL，再把结果映射成对象。用法简单，但细节决定是否健壮、安全、高效。
基础查询：Query 返回多行
这是最常用的查询方式，适合查列表、分页、批量数据。
必须指定泛型类型T（如
User、
Product），Dapper 会按属性名自动匹配列名（大小写不敏感） SQL 中用
@参数名占位，传参用匿名对象或实体对象，天然防 SQL 注入 返回
IEnumerable<t></t>，支持延迟执行；调用
.ToList()才真正取数
示例：
string sql = "SELECT Id, Name, Email FROM Users WHERE Age > @Age AND Status = @Status";
var users = connection.Query<User>(sql, new { Age = 18, Status = "Active" }).ToList();单行查询：选对方法很关键
不同场景要选不同方法，它们对“无结果”或“多结果”的处理逻辑完全不同：
QueryFirstOrDefault<t>()</t>：有就返回第一条，没有就返回
default(T)（null 或 0）——最常用
QueryFirst<t>()</t>：必须至少有一行，否则抛异常
QuerySingle<t>()</t>：必须且仅有一行，否则抛异常（适合主键精确查询）
QuerySingleOrDefault<t>()</t>：最多一行，有就返回，没就 null，多于一行则抛异常
示例：
var user = connection.QueryFirstOrDefault<User>("SELECT * FROM Users WHERE Id = @Id", new { Id = 123 });动态与匿名查询：不用定义类也能查
临时查、调试、导出、字段不确定时，可用
dynamic或匿名类型： 不带泛型的
Query()返回
IEnumerable<dynamic></dynamic>，每行是 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<user>(sql, buffered: false)</user>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<Product>(sql, new { categoryIds = new[] { 1, 5, 8 } }).ToList();基本上就这些。Dapper 的 Query 不复杂，但容易忽略参数安全、空值处理和缓冲策略这些细节。写 SQL 时保持简洁，映射时注意命名一致，再配合适当的方法选择，就能稳稳查出你要的数据。
