CodeIgniter分页类仅生成HTML和计算偏移量，不处理数据查询；需手动获取总数、截取数据，并正确配置base_url与uri_segment，CI4的Pager才支持自动分页。
CodeIgniter 的分页类（Pagination）本身不处理数据查询，只负责生成分页 HTML 和计算偏移量，所以“功能全吗”取决于你怎么用它——它足够轻量，但绝不自动帮你查数据库或适配不同 ORM。
分页类不接管数据查询，$this->pagination->create_links() 只输出 HTML
这是最容易误解的一点。CI 的 Pagination 类完全不知道你查了多少条数据、用的什么模型、是否用了 limit() 或 offset()。它只根据你传入的 total_rows、per_page、uri_segment 等参数算出当前页、总页数、链接地址，并返回一串 HTML 字符串。
常见错误现象：
- 页面显示分页链接，但点击后数据没变——因为你没在控制器里手动更新
limit和offset -
create_links()返回空字符串——大概率是total_rows为 0 或负数，或者per_page设成了 0
实操建议：
- 必须自己调用模型获取总数：
$total = $this->user_model->count_all(); - 必须手动截取数据：
$data['users'] = $this->user_model->limit($per_page, $offset)->get()->result(); -
$offset要从 URI 段中读取，通常用$this->uri->segment(3)（假设 URL 是/users/page/15）
base_url 和 uri_segment 配置错一个，分页链接就 404
CI 分页链接默认拼接的是完整 URL，但如果你的路由用了伪静态（比如 users/page/2）、或启用了子目录部署（如 http://example.com/myapp/），base_url 和 uri_segment 就必须显式指定，否则生成的链接会指向错误路径。
实操建议：
-
base_url应设为不含页码的基准路径，例如：'base_url' => site_url('users/index')或'base_url' => '/users/index' -
uri_segment必须对应实际分页参数所在 URI 段号，比如 URL 是/admin/users/20，且页码在第 3 段，则设'uri_segment' => 3 - 避免混用
site_url()和base_url()：前者加 index.php（若未重写），后者不加，选一个统一风格
自定义分页样式只能靠 full_tag_open 等参数，没法直接换模板文件
CI 3.x 的 Pagination 不支持 Twig 或视图文件注入，所有 HTML 结构都靠一堆字符串配置项硬控。想实现「上一页 / 下一页」文字、添加 Bootstrap class、或把数字页码包进 ，全得手写参数。
常用参数示例：
$config['full_tag_open'] = '<nav><ul class="pagination">'; $config['full_tag_close'] = '</ul></nav>'; $config['first_link'] = '« First'; $config['last_link'] = 'Last »'; $config['next_link'] = 'Next →'; $config['prev_link'] = '← Previous'; $config['num_tag_open'] = '
注意点：
-
cur_tag_open和cur_tag_close包住的是当前页数字，不是链接；如果要让它可点击，得额外改逻辑（CI 默认当前页不带） - Bootstrap 5 要求
内部用或，而 CI 默认对当前页用，这反而是符合规范的 - 别漏掉
attributes参数（CI 3.1.11+ 支持），可统一给所有链接加class="page-link"
CI 4 的 Pager 更灵活，但和 CI 3 的 Pagination 不兼容
CI 4 把分页逻辑拆成 Pager 类 + 数据库的 paginate() 方法，支持自动计算总数、自动注入 offset/limit、还能配合 Model::paginate() 一行搞定。但它和 CI 3 的配置方式、方法名、返回结构完全不同，不能平滑迁移。
CI 4 典型用法：
$pager = \Config\Services::pager(); $users = $this->userModel->paginate(10, 'group1'); // 自动处理 limit/offset $data['pager'] = $this->userModel->pager;
关键差异：
- CI 4 的
paginate()会自动执行两次查询（一次 count，一次 select），CI 3 必须手动写两次 - CI 4 的分页链接默认基于当前 URL，不用再配
base_url，但需确保路由允许 query string（如?page=2）或启用伪静态支持 - CI 4 的
Pager支持多组分页共存（通过group参数隔离），CI 3 只能单实例
如果你还在用 CI 3，别指望靠升级某个 helper 就获得 CI 4 的能力；真要灵活性，要么自己封装一个带查询逻辑的分页服务类，要么接受它的契约：分页归分页，数据归数据——边界清晰，但也意味着每处列表都要写几行固定样板。
