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