如何在Sqflite中快速插入多条记录？

嘿，这个问题问到点子上了！逐条循环调用insert确实不是高效的做法——每次插入都要单独和数据库做交互，频繁的IO操作会拖慢整体性能，数据量大的时候尤其明显。下面给你分享几种靠谱的优化方案，按推荐程度排序：

1. 使用Sqflite的Batch批量操作（最推荐） #

Sqflite专门提供了Batch API来处理批量数据库操作，它能把多个插入请求打包成一组，一次性发送给数据库执行，性能比普通循环+事务还要好。

代码示例：

// 先创建一个batch实例
var batch = database.batch();

// 遍历你的数据列表，把所有插入操作添加到batch里
for (var item in yourDataList) {
  // 可以根据需求添加冲突处理，比如重复时替换/忽略
  batch.insert(
    yourTableName,
    item.toMap(),
    conflictAlgorithm: ConflictAlgorithm.replace,
  );
}

// 提交batch，执行所有操作
await batch.commit();

为什么用Batch？ #

• 相比单独循环插入，它减少了数据库交互的次数，大幅提升性能
• 同样支持原子性：要么所有插入都成功，要么全部回滚
• 写法简洁，还能方便处理冲突场景

2. 用事务包裹循环插入 #

如果你的场景不适合用Batch（比如需要在插入过程中做一些额外逻辑判断），可以把循环放在事务里执行。事务会把所有操作打包成一个原子单元，避免了每次插入都提交事务的开销。

代码示例：

await database.transaction((txn) async {
  for (var item in yourDataList) {
    await txn.insert(yourTableName, item.toMap());
    // 这里可以加一些自定义逻辑，比如插入后更新某个状态
  }
});

优势： #

• 保证数据一致性，不会出现部分插入成功的情况
• 比无事务的循环插入性能提升明显

3. 拼接SQL语句批量插入（慎用） #

你也可以手动拼接一条包含所有数据的INSERT语句来实现批量插入，但这种方法需要注意SQL注入风险和特殊字符转义的问题，只适合数据完全可控的场景。

安全的参数化写法示例：

if (yourDataList.isEmpty) return;

// 获取字段名
final columnNames = yourDataList.first.toMap().keys.join(',');
// 生成占位符，每条数据对应一组?
final valuePlaceholders = yourDataList
    .map((_) => '(${List.filled(yourDataList.first.toMap().length, '?').join(',')})')
    .join(',');
// 把所有数据值展开成一个列表
final allValues = yourDataList.expand((item) => item.toMap().values).toList();

// 执行批量插入
await database.rawInsert(
  'INSERT INTO $yourTableName ($columnNames) VALUES $valuePlaceholders',
  allValues,
);

注意事项： #

• 不要直接拼接用户输入的数据到SQL里，一定要用占位符
• 如果数据量极大，这条SQL语句可能会过长，导致数据库报错，这种情况还是用Batch更稳妥

内容的提问来源于stack exchange，提问作者AlexPad