Golang分页实现与查询示例
分页需传入页码和每页大小，计算偏移量实现数据库查询，返回数据及总数。1.定义page和page_size参数；2.计算offset=(page-1)*page_size；3.执行LIMIT与OFFSET查询；4.获取总记录数；5.构建含数据、总数、分页信息的响应结构并返回JSON。
分页需传入页码和每页大小，计算偏移量实现数据库查询，返回数据及总数。1. 定义page和page_size参数；2. 计算offset=(page-1)*page_size；3. 执行LIMIT与OFFSET查询；4. 获取总记录数；5. 构建含数据、总数、分页信息的响应结构并返回JSON。
在使用Golang开发Web应用或API服务时，数据分页是一个常见需求。无论是查询数据库中的用户列表、文章信息还是订单记录，一次性返回大量数据不仅影响性能，还会增加网络开销。因此，实现高效的分页功能至关重要。本文将介绍如何在Golang中实现分页查询，并提供实际示例。
分页参数设计
通常分页需要两个核心参数：
- page：当前页码（一般从1开始）
- page_size 或 limit：每页显示的数据条数
根据这两个参数可以计算出SQL查询所需的偏移量：
offset = (page - 1) * page_size数据库查询实现（以MySQL为例）
假设我们有一个文章表articles，结构如下：
CREATE TABLE articles (
id INT AUTO_INCREMENT PRIMARY KEY,
title VARCHAR(100),
content TEXT,
created_at DATETIME
);使用database/sql或GORM进行分页查询：
// 使用 database/sql 示例
func GetArticles(db sql.DB, page, pageSize int) ([]Article, int, error) {
offset := (page - 1) pageSize
query := SELECT id, title, content, created_at FROM articles ORDER BY created_at DESC LIMIT ? OFFSET ?
rows, err := db.Query(query, pageSize, offset)
if err != nil {
return nil, 0, err
}
defer rows.Close()
var articles []Article
for rows.Next() {
var article Article
err := rows.Scan(&article.ID, &article.Title, &article.Content, &article.CreatedAt)
if err != nil {
return nil, 0, err
}
articles = append(articles, article)
}
// 查询总记录数
var total int
err = db.QueryRow(SELECT COUNT(*) FROM articles).Scan(&total)
if err != nil {
return nil, 0, err
}
return articles, total, nil
}
构建分页响应结构
前端通常需要知道总数量、当前页、每页大小等信息，定义一个通用的分页响应结构体：
type PaginationResponse struct {Data interface{} `json:"data"`
Total int `json:"total"`
Page int `json:"page"`
PageSize int `json:"page_size"`
HasMore bool `json:"has_more"`
}
在HTTP处理函数中返回分页结果：
func ArticlesHandler(w http.ResponseWriter, r *http.Request) {page := parseInt(r.URL.Query().Get("page"), 1)
pageSize := parseInt(r.URL.Query().Get("page_size"), 10)
articles, total, err := GetArticles(db, page, pageSize)
if err != nil {
http.Error(w, err.Error(), 500)
return
}
response := PaginationResponse{
Data: articles,
Total: total,
Page: page,
PageSize: pageSize,
HasMore: page*pageSize < total,
}
w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode(response)
使用GORM简化分页操作
如果项目中使用GORM，可以更简洁地实现分页：
func GetArticlesWithGORM(db *gorm.DB, page, pageSize int) (*PaginationResponse, error) {var articles []Article
var total int64
db.Model(&Article{}).Count(&total)
db.Scopes(Paginate(page, pageSize)).Find(&articles)
return &PaginationResponse{
Data: articles,
Total: int(total),
Page: page,
PageSize: pageSize,
HasMore: page*pageSize < int(total),
}, nil
}
// Paginate 是一个可复用的 GORM Scope
func Paginate(page, pageSize int) func(db *gorm.DB) *gorm.DB {
offset := (page - 1) * pageSize
return func(db *gorm.DB) *gorm.DB {
return db.Offset(offset).Limit(pageSize)
}
}
基本上就这些。通过合理设计分页参数、正确计算偏移量，并结合数据库查询与响应封装，就能在Golang中高效实现分页功能。注意对输入参数做校验，避免恶意请求导致性能问题。对于大数据量场景，建议使用游标分页（cursor-based pagination）替代传统offset方式，提升查询效率。
正软商城本月促销专区，汇集办公、设计、安全、影音、系统工具及AI软件等正版软件优惠活动，提供限时折扣、特价授权和优惠购买信息，活动库存及价格以页面实时展示为准。
正软商城装机必备专区，精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件，帮助用户快速完成新电脑软件配置。
正软商城Windows软件专区，汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件，提供软件介绍、系统要求、正版授权及购买下载服务。
正软商城macOS软件专区，精选适用于Mac电脑的办公、设计、影音、效率、开发和系统工具，提供软件功能介绍、macOS兼容版本、正版授权及购买下载服务。
正软商城iOS软件专区，精选适用于iPhone和iPad的办公、学习、影音、设计、效率及AI应用，提供功能介绍、适用设备、系统要求和正版获取方式等信息。
正软商城AI软件专区，汇集AI写作、AI绘画、AI视频、AI办公、AI编程、AI翻译、智能客服和数据分析等人工智能工具，提供功能介绍、适用平台、收费方式及正版购买信息。
正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法，同时介绍常用PDF软件和工具的使用技巧。
赤友清理大师是一款为 Mac 设计的智能清理优化工具，可精准扫描垃圾、大文件、重复文件等，释放磁盘空间。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
Wise Folder Hider Pro 是一款专业级文件和文件夹隐藏加密软件，为私密数据添加多重保护。高频操作更强调就近处理，浏览、整理和跨目录移动文件时，来回切换和重复点击都会少很多。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
