分页需控制查询范围、返回元数据并校验参数。使用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为例：
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过滤）。
构建通用分页响应结构
返回前端的数据应包含分页元信息，便于前端控制翻页。定义一个通用响应结构体：
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)
<p>var users []User
db.Limit(pageSize).Offset((page-1)*pageSize).Find(&users)</p><p>response := PaginatedResponse{
Data: users,
Total: total,
Page: page,
PageSize: pageSize,
TotalPages: int(math.Ceil(float64(total) / float64(pageSize))),
}</p>
处理边界与异常输入
用户可能传入负数页码或超大的page_size，需进行校验：
if page 100 {
pageSize = 100 // 限制最大值防刷
}
还可以封装成工具函数，复用在多个Handler中。
基本上就这些。核心是控制查询范围、返回必要元数据，并做好安全校验。不复杂但容易忽略细节。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
