本文介绍如何在 Go 中实现美观、高效的智能分页渲染，支持「首页+邻近页+省略号+尾部页」结构（如 ），避免全量遍历，兼顾边界情况与性能。
本文介绍如何在 go 中实现美观、高效的智能分页渲染，支持「首页+邻近页+省略号+尾部页」结构（如 ``），避免全量遍历，兼顾边界情况与性能。
在 Web 开发中，分页不应简单罗列全部页码（尤其当总页数达数百时），而应采用上下文感知的智能截断策略：固定显示首尾若干页，围绕当前页展示邻近页，并用 ... 表示被省略的连续区间。以下是经过生产验证的 Go 实现方案，兼顾可读性、健壮性与扩展性。
✅ 核心逻辑：三段式分页生成
我们把最终页码序列划分为三个逻辑段：
-
前缀段：固定显示前
start页（默认2页：1, 2）； -
中心段：以当前页
n为中心，左右各延伸around页（如around=3→[n-3, n+3]）； -
后缀段：固定显示末尾
end页（默认2页：totalPages-1, totalPages）；
各段之间通过 ... 连接，且自动跳过重叠或越界区域。
? 完整可运行示例（含 HTML 渲染）
package main
import (
"fmt"
"strings"
)
// PageRenderer 将页码或分隔符渲染为 HTML <li> 元素
type PageRenderer func(page int) string
// GeneratePagination 生成智能分页 HTML 列表项（<li>...</li>）
// n: 当前页（从 1 开始）, total: 总页数, around: 当前页邻近页数量, start/end: 首/尾固定页数
func GeneratePagination(n, total, around, start, end int, render PageRenderer) string {
var parts []string
var i int
// ? 前缀：1, 2, ..., start
for i = 1; i <= start && i <= total; i++ {
parts = append(parts, render(i))
}
// ? 前缀与中心段之间加 ...
if i < n-around && i <= total {
parts = append(parts, render(-1)) // -1 表示省略号
i = n - around
if i < 1 {
i = 1
}
}
// ? 中心段：[n-around, n+around]
for ; i <= n+around && i <= total; i++ {
parts = append(parts, render(i))
}
// ? 中心段与后缀之间加 ...
if i < total-end+1 && i <= total {
parts = append(parts, render(-1))
i = total - end + 1
if i < 1 {
i = 1
}
}
// ? 后缀：total-end+1, ..., total
for ; i <= total; i++ {
parts = append(parts, render(i))
}
return strings.Join(parts, "")
}
func main() {
// 示例：当前页=10，总页数=21，邻近页=3，首尾各显示 2 页
html := GeneratePagination(10, 21, 3, 2, 2, func(page int) string {
if page == -1 {
return `<li class="more"><span>…</span></li>`
}
isActive := page == 10
cls := ""
if isActive {
cls = ` class="active"`
}
return fmt.Sprintf(`<li%s><a href="?page=%d&limit=10">%d</a></li>`, cls, page, page)
})
fmt.Println("<ul>")
fmt.Println(html)
fmt.Println("</ul>")
}✅ 输出效果（节选）：
<ul></ul><li><a href="?page=1&limit=10">1</a></li><li><a href="?page=2&limit=10">2</a></li><li class="more"><span>…</span></li><li><a href="?page=7&limit=10">7</a></li><li><a href="?page=8&limit=10">8</a></li><li><a href="?page=9&limit=10">9</a></li><li class="active"><a href="?page=10&limit=10">10</a></li><li><a href="?page=11&limit=10">11</a></li><li><a href="?page=12&limit=10">12</a></li><li><a href="?page=13&limit=10">13</a></li><li class="more"><span>…</span></li><li><a href="?page=20&limit=10">20</a></li><li><a href="?page=21&limit=10">21</a></li>
⚠️ 关键注意事项
-
页码从 1 开始：所有参数（
n,total,start,end）均按人类习惯使用 1-based 索引，无需手动 ±1； -
边界自动兜底：当
n-around 或 <code>n+around > total时，中心段自动收缩，不 panic； - 零内存分配（除结果切片）：算法仅用 O(1) 额外空间，时间复杂度 O(k)，k 为最终渲染页码数（通常 ≤ 10）；
-
解耦渲染逻辑：
render回调允许自由定制 HTML、JSON、纯文本等输出格式，便于集成模板引擎（如html/template）； -
避免常见陷阱：
- ❌ 不要预分配大数组（如
make([]string, totalPages)）； - ❌ 不要硬编码
page-1,page+1等魔术数字； - ✅ 使用
start/end/around参数灵活适配设计规范（如 Material Design 要求首尾各 1 页 + 中心 5 页）。
- ❌ 不要预分配大数组（如
? 是否需要第三方库？
Go 生态中暂无主流、轻量、专注分页渲染的通用库。本方案优势在于：
- 零依赖：纯标准库实现；
-
可嵌入性强：可直接作为
utils/pagination.go复用； -
易测试：输入/输出明确，适合编写 table-driven 测试用例（覆盖
n=1,n=total,total=1,around=0等边界）。
? 提示：若需服务端渲染集成，可将
GeneratePagination封装为html/template的自定义函数；若用于 API，则将render改为返回map[string]interface{}即可输出 JSON 分页元数据。
掌握该模式后，你不仅能写出符合 UX 规范的分页控件，更建立起「按需生成」而非「全量枚举」的工程思维——这正是 Go 式简洁与高效的核心体现。
