ThinkPHP 的 saveAll 并非真正批量插入，而是循环执行单条 save()；需确保数据不含主键、模型定义正确主键、使用实例调用且传入规范二维数组，才能安全新增。
ThinkPHP 的 saveAll 可以批量新增数据，但它**不是真正意义上的批量 SQL 插入**，而是循环调用单条 save()。所以“批量新增”指的是语法上一次传入多条数据，底层仍是逐条执行 INSERT —— 这一点必须明确，否则容易误判性能和行为。
saveAll 新增数据的前提条件
要让 saveAll 正确执行新增（而非意外更新），需同时满足：
- 数据数组中**不包含主键字段值**（如
id），或确保该主键在数据库中不存在； - 模型类中定义了正确的主键：
protected $pk = 'id';； - 传入的是二维关联数组，每个子数组键名必须与数据库字段名严格一致（例如不能传
user_id却期望映射到id）； - 使用模型实例调用：
(new User())->saveAll($data)，不能静态调用User::saveAll()（TP6 不支持）。
如何确保只新增、不误更新
saveAll 会根据是否有主键值 + 数据库是否存在该主键，自动判断 INSERT 或 UPDATE。若想强制新增，有几种方式：
- 传入数据时**完全不带主键字段**（如
id），尤其适用于自增主键表； - 若数据里含主键（比如 UUID），但你确认它一定不存在，可放心传入；
- 避免使用
->isUpdate(true)，这个是强制走更新逻辑，和新增目标相反； - 调试时加
Db::name('user')->fetchSql(true)->saveAll($data)，直接看生成的 SQL 是INSERT还是UPDATE。
小批量新增推荐写法（带验证/事件）
适合表单提交、后台录入等 10–100 条、需自动时间戳、验证器、beforeInsert 等模型能力的场景：
立即学习“PHP免费学习笔记（深入）”；
$data = [
['name' => '张三', 'email' => 'z3@example.com'],
['name' => '李四', 'email' => 'l4@example.com'],
];
$result = (new User())->saveAll($data);
// 成功返回 ID 数组（自增主键）或 true（非自增）
// 失败返回 false，可用 User::getError() 查最后一条错误
大批量新增不建议直接用 saveAll
500 条以上就明显吃力：500 次模型实例化 + 500 次验证 + 500 次 SQL 执行，易超时、OOM、连接耗尽。此时应：
- 改用
Db::insertAll($data)：单条多值 INSERT，无模型开销，快且稳； - 若仍要用
saveAll（比如必须触发事件），则必须分块 + 关验证 + 包事务：
$chunks = array_chunk($data, 200);<br> foreach ($chunks as $chunk) {<br> Db::transaction(fn() => (new User())->validate(false)->saveAll($chunk));<br> } - 手动补时间戳：
insertAll不自动填create_time，得在数据里自己加：'create_time' => date('Y-m-d H:i:s')。
