该用 saveAll() 还是 insertAll() 取决于是否需要模型逻辑：需验证、事件、自动时间戳时用 saveAll()；纯数据搬运且字段已对齐时用 insertAll()。
saveAll() 和 insertAll() 到底该用哪个
模型层逻辑强（要验证、要事件、要自动时间戳）就用 saveAll()；纯数据搬运、字段已对齐、不走模型逻辑，直接上 Db::name('table')->insertAll($data)。前者返回 ID 数组（自增主键下），后者只返回影响行数 int，且不填充 create_time 等字段。
常见错误是混用：比如在 insertAll() 里传带 id 的数组却没建唯一索引，结果重复插入失败；或在 saveAll() 里传了非法字段名，触发模型验证直接报错中断。
-
saveAll()会读取模型配置、触发before_write钩子、走验证器——若数据已清洗干净，加['validate' => false]能提速 30% 以上 -
insertAll()不查模型、不初始化验证器，内存占用低，适合日志归档、后台导入等场景 - 两者都不支持自动类型转换（如把字符串
'2026-04-24'转成日期），字段值必须是数据库能直接受纳的格式
单次插多少条才安全
别信“越多越好”。MySQL 默认 max_allowed_packet=4M，按平均每行 200 字节算，500 条就逼近极限；PHP CLI 下内存也容易爆。实测稳妥区间是 200–400 条/批。
超量的典型报错是：Packets larger than max_allowed_packet are not allowed，或者 PHP 报 Allowed memory size exhausted。
立即学习“PHP免费学习笔记（深入）”；
- 用
array_chunk($data, 400)主动切片，别依赖框架自动分批 - Web 请求中严禁一次性处理 >1 万条——Nginx 默认超时 30 秒，应改用队列（如 think-worker）
- CLI 脚本记得加
set_time_limit(0)和gc_collect_cycles()，尤其循环处理多批次时
事务包裹不是可选项，是必填项
批量写入中途出错，默认是“前面成功、后面失败”，数据残缺且无法回滚。不加事务的 insertAll() 就是埋雷。
正确姿势只有一种：Db::transaction(function () use ($chunks) { foreach ($chunks as $chunk) { Db::name('user')->insertAll($chunk); } });。异常时自动回滚，不用手动写 rollback()。
- 别在事务里调外部 API、发邮件、写文件——锁表时间拉长，高并发下极易阻塞其他请求
- 避免在循环内反复 new 模型实例，复用同一个对象，例如
$user = new User(); $user->saveAll($chunk) - 如果用
saveAll()，确保模型里没定义会导致部分失败的钩子（如某个afterWrite抛异常）
Excel 导入时最容易漏掉的三件事
不是读完 Excel → 组数组 → insertAll() 就完事。90% 的线上问题出在解析阶段：科学计数法丢精度、空单元格变字符串 ''、标题含不可见字符。
比如 Excel 里显示 13912345678，实际存的是 1.39123E+10，直接取值会变成 13912300000。
- 读取前必须调
$reader->setReadDataOnly(true)，关样式解析，省内存又提速 - 标题行用
trim(str_replace(["\n","\r"], "", $cell->getValue()))清洗，再匹配字段名 - 数值列优先用
$cell->getDataType() === \PhpOffice\PhpSpreadsheet\Cell\Cell::TYPE_NUMERIC判断，再用$cell->getFormattedValue()取原始显示值
