CodeIgniter 3 的 insert_batch() 是框架唯一封装的批量插入方式，本质为多条单 INSERT 执行，不支持原生多值语法，需传二维关联数组且键名严格匹配字段名，返回影响行数总和或 FALSE。
CodeIgniter 3 的 insert_batch() 是唯一靠谱的批量插入方式
CI3 官方不支持原生多值 INSERT（比如 INSERT INTO t VALUES (),(),()），insert_batch() 是框架层唯一封装好的批量入口，它本质是把数组拆成单条 insert() 批量执行，不是真·单 SQL。别指望它能绕过 MySQL 的 max_allowed_packet 限制——数据量大时照样报错。
- 必须传入二维关联数组，键名需严格匹配字段名：
[['name' => 'a', 'age' => 20], ['name' => 'b', 'age' => 22]] - 不自动转义字段名，如果字段含空格或关键字（如
order），得手动加反引号：$this->db->field_bind('`order`', $value)不起作用，得改数组键为'`order`' - 返回的是影响行数总和（int），不是布尔值；失败时只返回
FALSE，不告诉你哪一条错了
CI4 的 insertBatch() 默认走预处理，但默认不开启事务
CI4 把批量插入升级成带参数绑定的预处理语句，安全性提升，但默认每条记录单独执行 INSERT，性能没比 CI3 好多少。真正提速得靠显式事务 + 合理分块。
- 分块大小建议控制在 500 行内，超了容易触发 MySQL 的
wait_timeout或连接中断 - 必须手动包事务：
$this->db->transStart(); $this->db->table('users')->insertBatch($data); $this->db->transComplete(); - 如果表有自增主键，
insertBatch()不会返回所有生成的 ID，只返回第一条的 ID —— 别依赖它做后续关联
“批量插入很慢”大概率是因为没关 auto-commit 或没设 stricton
CI 默认每条 insert() 都提交一次，批量时 IO 次数爆炸。MySQL 服务端若开 strict mode，遇到空字符串插非空字段、时间字段填非法值等情况，整批直接失败，错误提示还藏在 $this->db->error() 里，不查就以为是超时。
- CI3：在数据库配置里加
'stricton' => FALSE，或连接后执行$this->db->query('SET sql_mode = ""'); - CI4：在
.env里设database.default.DSN="mysql:host=localhost;dbname=test;charset=utf8mb4;strict=0" - 无论哪个版本，批量前务必确认
$this->db->transOff()没被意外调用过，否则事务不起效
想绕过框架直接拼 SQL？小心字符编码和 NULL 处理
手写 INSERT INTO …… VALUES (……),(……) 确实最快，但 CI 的查询构建器不提供这种接口，你得自己拼。这时候最常踩的坑不是语法，是 NULL 值和中文乱码。
-
NULL必须字面量写成NULL，不能加引号，也不能用'NULL'或空字符串代替 - 字符串值必须用
$this->db->escape()处理，别用addslashes()—— 后者不识别 MySQL 的编码上下文 - 如果数据含换行符或制表符，MySQL 可能解析错位，建议先用
str_replace(["rn", "n", "r", "t"], ' ', $val)清洗
实际用下来，CI3 的 insert_batch() 和 CI4 的 insertBatch() 在千级数据下差异不大，真正卡住的往往是日志开关、调试模式开着，或者数据库连接用了 pconnect 却没配好超时。这些细节不盯住，换啥方法都慢。
