Dapper 使用 @参数名 作为参数占位符，SQL 中必须带 @ 前缀（如 @Id），C# 传参对象属性名不带 @（如 Id），大小写需一致；支持数组 IN 查询自动展开；复杂场景推荐 DynamicParameters。
Dapper 使用 @参数名 作为标准的参数占位符，这是它参数化查询的核心机制。@ 符号本身不是 SQL 语法的一部分，而是 Dapper 约定的命名前缀，用于将 C# 对象属性或匿名对象字段映射到 SQL 中的参数位置。
参数命名必须带 @ 前缀（SQL 语句中）
在写 SQL 字符串时，所有参数都必须显式以 @ 开头，比如：
SELECT * FROM Users WHERE Id = @Id AND Status = @StatusINSERT INTO Logs (Msg, Time) VALUES (@Msg, @Time)
Dapper 会自动提取 @ 后面的名称（如 Id、Status），然后去传入的参数对象中查找同名属性或字段。不加 @，Dapper 就无法识别为参数，直接当作字面量处理，容易引发 SQL 注入或运行时报错。
传参对象里的属性名不加 @
你在 C# 里构造参数时，属性名不能带 @，否则匹配失败：
- ✅ 正确：
new { Id = 123, Status = "Active" } - ❌ 错误：
new { @Id = 123, @Status = "Active" }（C# 语法错误） - ❌ 无效：
new { Id = 123, Status = "Active", "@Id" = 123 }（字符串键名无法被 Dapper 自动映射）
也就是说：SQL 里写 @Id，C# 里用 Id；大小写需完全一致（默认区分大小写）。
支持 DynamicParameters 动态添加带 @ 的参数
当需要更精细控制（比如输出参数、指定 DbType 或方向），推荐用 DynamicParameters：
parameters.Add("@UserId", 1001, DbType.Int32);parameters.Add("@Result", dbType: DbType.Int32, direction: ParameterDirection.Output);
注意：这里 Add 方法的第一个参数是完整参数名（含 @），Dapper 会原样传递给底层 ADO.NET。这也是解决“必须声明标量变量 @xxx”错误的正确方式——别用原生 SqlParameter，改用 DynamicParameters。
IN 查询和数组参数的特殊处理
Dapper 支持简洁的数组参数语法，无需手动展开：
- SQL 中写：
WHERE Id IN @Ids - C# 中传：
new { Ids = new[] { 1, 2, 3 } }
Dapper 会自动把数组转成 @Ids0, @Ids1, @Ids2 并绑定值，整个过程仍遵循 @ 命名规则，只是隐藏了拼接细节。
基本上就这些。记住关键点：SQL 里带 @，C# 里不带 @，大小写敏感，复杂场景用 DynamicParameters —— 不复杂但容易忽略。
