Dapper执行Insert操作需手写SQL并调用Execute()，支持参数化（类实例或匿名对象）、获取自增ID（SELECT SCOPE_IDENTITY()）、事务批量插入；注意参数名一致、NULL值处理、DateTime时区及字符串长度。

用 Dapper 执行 Insert 操作非常直接：写 SQL 插入语句，调用 connection.Execute() 方法即可。它不自动生成 SQL，也不做模型映射（除非你手动传参），核心就是“SQL + 参数化”。

基础 Insert 写法（推荐参数化）

避免拼接字符串，防止 SQL 注入。Dapper 会自动把对象属性或匿名对象的字段映射为 SQL 参数：

• 用类实例插入：

  var user = new { Name = "张三", Email = "zhang@example.com", Age = 25 };
  using var conn = new SqlConnection(connStr);
  conn.Execute("INSERT INTO Users (Name, Email, Age) VALUES (@Name, @Email, @Age)", user);

• 用匿名对象更轻量，适合简单场景；用强类型类（如 User）更适合复用和校验。

获取插入后的自增 ID（SCOPE_IDENTITY）

如果表主键是 IDENTITY，常用 SELECT SCOPE_IDENTITY() 获取刚插入的 ID：

• 把 INSERT 和 SELECT 合并在一条命令里，用 ExecuteScalar()：

  var newId = conn.ExecuteScalar(@"
    INSERT INTO Users (Name, Email) VALUES (@Name, @Email);
    SELECT CAST(SCOPE_IDENTITY() AS INT);",
    new { Name = "李四", Email = "li@example.com" });

• 注意返回类型要匹配（比如 int、long），SQL Server 中 SCOPE_IDENTITY() 默认是 decimal，所以显式转成整型更稳妥。

批量插入（少量数据可用，大量建议 SqlBulkCopy）

Dapper 本身不提供原生批量插入，但可以循环执行 Execute 或用事务包住多条语句提升性能：

• 带事务的多条插入：

  using var conn = new SqlConnection(connStr);
  conn.Open();
  using var tran = conn.BeginTransaction();
  try
  {
    conn.Execute("INSERT INTO Logs (Msg, Level) VALUES (@Msg, @Level)",
      new[] {
        new { Msg = "Start", Level = "Info" },
        new { Msg = "Done", Level = "Info" }
      }, tran);
    tran.Commit();
  }
  catch
  {
    tran.Rollback();
    throw;
  }

• 几百条以内用这个够用；上万条请改用 SqlBulkCopy 或第三方扩展如 Dapper.FastCrud、DapperExtensions。

注意事项和常见坑

实际用的时候容易忽略这些细节：

• 字段名和参数名必须严格一致（大小写敏感取决于数据库配置，SQL Server 默认不区分，但建议统一小写）；
• NULL 值要传 null，别传空字符串或默认值，否则可能违反 NOT NULL 约束；
• DateTime 字段注意时区，.NET 的 DateTime 默认是 DateTimeKind.Unspecified，入库前建议明确指定 DateTimeKind.Utc；
• 字符串长度超限会报错，Dapper 不做截断，需业务层或数据库约束控制。

基本上就这些。Dapper 的 Insert 不复杂，但容易忽略参数命名和事务处理。写清楚 SQL，配好参数，再加点异常兜底，就能稳稳落地。