分页需控制查询范围、返回元数据并校验参数。使用page和page_size计算offset，结合LIMIT与OFFSET实现数据库分页，但深度分页应改用游标法；定义PaginatedResponse结构体返回数据、总数、页码等信息，并对输入进行合法性检查，防止性能问题与异常请求。
在Golang开发中，处理大量数据时实现分页是常见需求。无论是API接口返回列表数据，还是后台管理系统展示记录，直接加载全部数据会影响性能和用户体验。合理的分页机制可以提升响应速度、减少内存占用。下面介绍如何在Golang中实现高效、易用的数据分页。
理解分页基本参数
分页通常依赖几个关键参数：
- page：当前页码，一般从1开始
- page_size 或 limit：每页显示的条数
- offset：偏移量，计算方式为 (page - 1) * page_size
例如请求第2页，每页10条，则跳过前10条，取10条数据。这些参数应通过HTTP查询参数传入，并做校验防止非法输入。
数据库层面实现分页查询
最常见的是使用SQL的 LIMIT 和 OFFSET 进行分页。以MySQL为例：
立即学习“go语言免费学习笔记（深入）”；
SELECT id, name, created_at FROM users ORDER BY created_at DESC LIMIT ? OFFSET ?
在Golang中结合database/sql或GORM等ORM使用：
var users []User
offset := (page - 1) * pageSize
db.Limit(pageSize).Offset(offset).Order("created_at DESC").Find(&users)注意：OFFSET随着页码增大，性能会下降。对于深度分页（如第1000页），建议使用基于游标的分页（如按时间或ID排序后用WHERE过滤）。
部分功能简介：商品收藏夹功能热门商品最新商品分级价格功能自选风格打印结算页面内部短信箱商品评论增加上一商品，下一商品功能增强商家提示功能友情链接用户在线统计用户来访统计用户来访信息用户积分功能广告设置用户组分类邮件系统后台实现更新用户数据系统图片设置模板管理CSS风格管理申诉内容过滤功能用户注册过滤特征字符IP库管理及来访限制及管理压缩，恢复，备份数据库功能上传文件管理商品类别管理商品添加/修改/
构建通用分页响应结构
返回前端的数据应包含分页元信息，便于前端控制翻页。定义一个通用响应结构体：
type PaginatedResponse struct {
Data interface{} `json:"data"`
Total int64 `json:"total"`
Page int `json:"page"`
PageSize int `json:"page_size"`
TotalPages int `json:"total_pages"`
}在处理完查询后填充该结构：
var total int64
db.Model(&User{}).Count(&total)
var users []User
db.Limit(pageSize).Offset((page-1)*pageSize).Find(&users)
response := PaginatedResponse{
Data: users,
Total: total,
Page: page,
PageSize: pageSize,
TotalPages: int(math.Ceil(float64(total) / float64(pageSize))),
}
处理边界与异常输入
用户可能传入负数页码或超大的page_size，需进行校验：
if page < 1 {
page = 1
}
if pageSize < 1 {
pageSize = 10
}
if pageSize > 100 {
pageSize = 100 // 限制最大值防刷
}还可以封装成工具函数，复用在多个Handler中。
基本上就这些。核心是控制查询范围、返回必要元数据，并做好安全校验。不复杂但容易忽略细节。
