pagehelper-org/Mybatis-PageHelper

这是什么？

核心功能

• 01在数据库层面改写查询，只取回当前页的数据。
• 02根据 JDBC URL 自动识别数据库方言。
• 03支持多种数据库，包括达梦、人大金仓等国产数据库。
• 04可通过 dialectAlias 配置自定义方言。
• 05提供 Executor 级别的 QueryInterceptor 扩展接口。

适用场景

• 为使用 MyBatis 的 Java 服务添加分页列表接口。
• 无需手写 LIMIT 语句即可对复杂多表查询分页。
• 在达梦、人大金仓等国产数据库上使用 MyBatis 进行分页查询。

快速上手

1. 1

   在 pom.xml 中添加 pagehelper Maven 依赖（使用最新版本）

2. 2

   阅读使用文档以了解配置和用法

使用前须知

• !文档和 README 主要为中文，英文版本位于单独文件中。
• !需要已有 MyBatis 环境，并且 classpath 中包含 jsqlparser 库。

收录于专题

标签

常见问题

Mybatis-PageHelper 是什么？

为 MyBatis 查询添加物理分页的插件，可按数据库方言生成对应的分页 SQL。 PageHelper 是 MyBatis 的分页插件，无需手写分页 SQL。开发者在执行查询前调用一个静态方法，插件会改写 SQL，使数据库只返回当前页的数据。它既能处理单表查询，也能处理较复杂的多表分页。

Mybatis-PageHelper 可以免费使用吗？用的什么许可证？

Mybatis-PageHelper 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

Mybatis-PageHelper 还在维护吗？

活跃维护中。Mybatis-PageHelper 最近一次提交是在 2026年11月3日。

Mybatis-PageHelper 适合用来做什么？

为使用 MyBatis 的 Java 服务添加分页列表接口。 无需手写 LIMIT 语句即可对复杂多表查询分页。 在达梦、人大金仓等国产数据库上使用 MyBatis 进行分页查询。

Mybatis-PageHelper 怎么安装和运行？

在 pom.xml 中添加 pagehelper Maven 依赖（使用最新版本） 阅读使用文档以了解配置和用法

在哪里获取 Mybatis-PageHelper？

源代码和安装说明在 GitHub 上：https://github.com/pagehelper-org/Mybatis-PageHelper