CI4 推荐用 DataTable::of() 替代 CI3 的 Ignited-Datatables；前者封装服务器端协议、支持查询构建器链式调用、自动防注入，后者在 PHP 8.1+ 兼容性差、需大量 workaround 且易出错。
CodeIgniter 4 中用 DataTable::of() 就能直接渲染带搜索、排序、分页的表格；CI3 用 Ignited-Datatables 不仅要手动补一堆 workaround，还跑不起来 PHP 8.1+，新项目别碰。
CI4：用 DataTable::of() 替代手写 JSON 和分页逻辑
这个库把 DataTables 的服务器端协议（draw、start、length、search[value] 等）全封装好了，你只管传一个查询构建器实例进去。
-
DataTable::of()只接受Query\Builder实例，不能传数组、Model 或原始 SQL 字符串 - 列名必须和数据库字段严格一致——比如数据库是
customer_name，但前端配置了data: 'customerName'，就得在查询里加->addSelect('customer_name as customerName') - 自定义列（如操作按钮）用
->addColumn('action', function($row) { ... })，闭包里不能访问$this，也不能用$this->db - 所有 WHERE 条件、JOIN、ORDER 都走 CI4 查询构建器，自动防注入，支持链式调用
CI3：Ignited-Datatables 的三个致命兼容性坑
它底层靠 $this->db->from() + 手拼字符串实现，没抽象层，PHP 8.1+ 会直接报 Deprecated: strlen(): Passing null to strlen()，而且一用 GROUP BY 或复杂 JOIN 就崩。
- 必须在控制器里显式
$this->load->library('datatables')，autoload 不生效 - 加了
->add_column('action', ...)后，必须紧跟->unset_column('action')，否则它会对 HTML 字符串做模糊匹配，SQL 直接报错 - 用了
GROUP BY就得手动->select('COUNT(*) as count', FALSE)并关掉 escape，不然 COUNT 被加上引号变成'COUNT(*)'，语法错误 - 日期范围筛选这类需求，得自己用
$this->datatables->db->group_start()包住条件，它不提供高级 where 封装
前后端联调卡住时，先查这三处
90% 的 “表格空白”“请求 500”“排序失效”，根本不是逻辑问题，而是：
- 前端
columns.data和后端SELECT字段名不一致（大小写、下划线/驼峰混用） - CI4 里传了 Model 实例或数组给
DataTable::of()，报Call to undefined method - CI3 中漏了
->unset_column()，或者->select()里没关 escape 导致 GROUP BY 报错
最易被忽略的是列名映射——数据库字段、SELECT 别名、前端 data 配置，三者必须对齐，差一个下划线或大小写，search 和 order 就静默失效，连错误都不报。
