ThinkPHP 的 insertAll() 方法用于批量插入结构统一的二维数组数据，自动处理转义和类型转换，支持模型自动时间戳与验证，返回影响行数而非自增ID。
ThinkPHP 的 insertAll() 方法就是专门用来批量插入二维数组数据的，传入一个键名统一、结构相同的二维数组即可，不需要额外转换。
传入标准二维数组（推荐）
确保二维数组中每个子数组的键名一致，且与数据表字段名对应：
- 键名必须是数据库字段名（大小写敏感，建议小写）
- 每个子数组长度和结构应相同（缺失字段可设为
null或留空，但不建议） - 无需手动处理字符串转义或类型转换，框架会自动处理
示例：
```php$data = [
['name' => '张三', 'age' => 25, 'status' => 1],
['name' => '李四', 'age' => 30, 'status' => 1],
['name' => '王五', 'age' => 28, 'status' => 0],
];
Db::name('user')->insertAll($data);
```
配合模型使用（含自动时间戳/过滤等）
如果使用模型操作，insertAll() 同样支持二维数组，并会自动触发模型中的时间戳、自动完成、验证等逻辑：
立即学习“PHP免费学习笔记（深入）”；
- 需确保模型开启了
auto_write_timestamp或定义了createTime/updateTime - 字段白名单（
protected $field）会影响实际插入字段 - 若启用验证，建议先调用
validate(true)批量校验
示例：
```php$userModel = new UserModel();
$userModel->validate(true)->insertAll($data);
```
注意主键和返回值
insertAll() 默认不返回自增 ID 列表（除非底层数据库支持并开启 PDO::MYSQL_ATTR_USE_BUFFERED_QUERY），返回的是影响的记录数：
- 成功时返回插入的行数（如
3） - 失败时返回
false，可通过Db::getLastSql()查看执行语句 - 如需获取每条记录的自增 ID，需改用循环 +
insertGetId()（性能较低，慎用）
常见问题
如果报错 “非法数据格式” 或插入为空，大概率是：
- 二维数组里混入了非关联数组（如索引数组
[0 => 'a', 1 => 'b']），请用array_values()+ 显式键名规范结构 - 键名拼写错误或大小写不符（如数据库字段是
user_name，却写了username） - 存在
null值但对应字段设置了NOT NULL且无默认值
