Dapper 的 ExecuteScalar 用于执行 SQL 查询并返回结果集第一行第一列的值，适合获取 COUNT、SUM、MAX、单个字段等场景。 它不返回对象或列表，只取一个原始值（如 int、string、DateTime、Guid 等），用法简洁但需注意类型匹配和空值处理。
基本用法：查总数、取ID、拿最小值
ExecuteScalar 默认返回
object，建议用泛型方法
ExecuteScalar<t>()</t>直接获取指定类型，避免手动转换： 查记录数：
int count = conn.ExecuteScalar<int>("SELECT COUNT(*) FROM Users WHERE Status = @status", new { status = 1 });</int>
取最新插入ID（SQL Server）：int newId = conn.ExecuteScalar<int>("INSERT INTO Users (Name) VALUES (@name); SELECT CAST(SCOPE_IDENTITY() as int);", new { name = "张三" });</int>
查最大编号：string maxCode = conn.ExecuteScalar<string>("SELECT MAX(Code) FROM Products");</string>
注意空结果和 NULL 值处理
如果查询没返回任何行（比如 WHERE 条件不匹配），ExecuteScalar 返回
null（引用类型）或引发异常（值类型如
int）。安全写法： 用可空类型接收：
int? id = conn.ExecuteScalar<int>("SELECT Id FROM Users WHERE Email = @email", new { email = "x@y.z" });</int>
数据库字段可能为 NULL？确保 SQL 中用 ISNULL或
COALESCE提供默认值：
conn.ExecuteScalar<int>("SELECT COALESCE(MAX(SortOrder), 0) FROM Categories")</int>
配合参数和异步操作
支持匿名对象、DynamicParameters 和异步调用：
用 DynamicParameters 更灵活传参：var p = new DynamicParameters(); p.Add("@minAge", 18, DbType.Int32); var avg = conn.ExecuteScalar<decimal>("SELECT AVG(Score) FROM Students WHERE Age >= @minAge", p);</decimal>
异步版本：int count = await conn.ExecuteScalarAsync<int>("SELECT COUNT(*) FROM Logs WHERE CreatedAt > @since", new { since = DateTime.Today });</int>
基本上就这些。记住核心：它只拿“第一个值”，别指望它返回一行或多行；类型要对得上，NULL 要兜得住；有异步需求就用
ExecuteScalarAsync。
