saveAll本质是循环调用单条save，非真批量SQL；适合小批量（≤200条）、需验证/事件/自动填充等模型能力的场景，大数据量应改用Db::insertAll或分块事务处理。
saveAll 是 ThinkPHP 模型层提供的批量写入方法，本质是“带模型逻辑的循环插入/更新”，不是真正的单条批量 SQL。 它适合需要验证、自动填充、事件钩子等业务逻辑的场景，但性能明显低于原生批量操作。
它怎么工作
saveAll 不会生成一条 INSERT INTO ... VALUES (),(),() 语句，而是对每条数据调用一次模型的 save() 方法：
- 逐条走验证器（require、email、in 等规则）
- 触发 before_insert / after_insert 等模型事件
- 自动填充 create_time、update_time 等时间字段
- 执行类型转换（如 json 字段自动序列化）
- 根据是否含主键值，自动判断是 INSERT 还是 UPDATE
什么时候该用 saveAll
当你需要模型层的完整性保障，而不是单纯追求速度时：
- 表单提交的多行数据，字段不统一（有的带 status，有的带 remark）
- 必须校验邮箱格式、手机号长度等业务规则
- 依赖 before_insert 修改数据（比如生成 UUID、计算积分）
- 要记录操作日志或同步到其他服务（通过 after_insert）
- 数据量小（通常 ≤ 200 条），或已分块处理（如 array_chunk($data, 100)）
关键注意事项
用错容易踩坑，几个硬性细节必须清楚：
立即学习“PHP免费学习笔记（深入）”；
- 只能用实例调用：(new User())->saveAll($data)，不能 User::saveAll($data)
- 字段名必须和模型定义的主键名完全一致（如 $pk = 'id'，数据里就得是 ['id'=>1]，不是 ['user_id'=>1]）
- 不在模型 $schema 或数据库中的字段会被静默丢弃，不报错
- 默认开启验证，可信数据可加 ['validate'=>false] 提速
- 返回值取决于主键：自增 ID 返回 ID 数组；UUID 等非自增主键只返回 true/false
它不适合什么场景
以下情况请绕开 saveAll，改用 Db::insertAll() 或手拼批量 SQL：
- Excel 导入上万条基础数据（无业务校验）
- 后台定时同步日志、埋点等高频写入
- 要求毫秒级响应的高并发写入
- 已确认数据干净，只求最快入库
