本文介绍如何在 Go 模板中对时间戳数据进行逆序排序与按年分组渲染，通过实现 sort.Interface 和自定义模板函数 newYear，实现在不修改数据源的前提下，优雅输出“年份标题 + 该年所有文章”的归档视图。
本文介绍如何在 go 模板中对时间戳数据进行逆序排序与按年分组渲染，通过实现 `sort.interface` 和自定义模板函数 `newyear`，实现在不修改数据源的前提下，优雅输出“年份标题 + 该年所有文章”的归档视图。
在构建博客或内容归档页面时，常需将文章按发布年份分组，并以「最新年份优先」的顺序展示（如 2024 → 2023 → 2022）。Go 的 html/template 本身不支持原生分组或复杂排序，因此需结合 Go 后端逻辑与模板辅助函数协同完成。
✅ 步骤一：实现 sort.Interface 并逆序排序
首先，为你的文章集合类型（例如 Posts）实现 sort.Interface 接口，确保可按 PostDate 升序排列；再通过 sort.Reverse 包装实现降序（即逆序）：
type Posts struct {
Posts []Post
}
func (p Posts) Len() int { return len(p.Posts) }
func (p Posts) Less(i, j int) bool { return p.Posts[i].PostDate.Before(p.Posts[j].PostDate) }
func (p Posts) Swap(i, j int) { p.Posts[i], p.Posts[j] = p.Posts[j], p.Posts[i] }在处理 HTTP 请求或准备模板数据时，调用：
posts := Posts{yourPostSlice}
sort.Sort(sort.Reverse(posts)) // 关键：得到按时间倒序排列的切片此时 posts.Posts 已按 PostDate 从新到旧排列，满足「最新年份优先」的基础要求。
✅ 步骤二：在模板中按年分组 —— 使用闭包式模板函数
Go 模板无法维护状态，但可通过注册带闭包的 template.FuncMap 函数，在渲染过程中动态追踪「上一个年份」，从而判断是否需要插入年份标题：
currentYear := ""
funcMap := template.FuncMap{
"newYear": func(yearStr string) bool {
if yearStr != currentYear {
currentYear = yearStr
return true // 需要渲染年份标题
}
return false // 复用上一个年份，跳过标题
},
}
tmpl := template.Must(template.New("archive").Funcs(funcMap).Parse(tmplStr))⚠️ 注意：currentYear 必须定义在 FuncMap 外部作用域（如 handler 函数内），确保每次模板执行使用独立状态；若复用全局变量会导致并发安全问题。
✅ 步骤三：模板中编写分组逻辑
假设传入模板的数据是 []Post（已排序），模板可简洁表达为：
{{ range . }}
{{ if newYear (.PostDate.Format "2006") }}
<h2 class="year-header">{{ .PostDate.Format "2006" }}</h2>
<ul class="year-posts">
{{ end }}
<li>
{{ .PostDate.Format "2006 Jan 02" }} »
<a href="{{ .URL }}">{{ .Title }}</a>
</li>
{{ if newYear ($.PostDate.Format "2006") }}
</ul>
{{ end }}
{{ end }}? 提示：末尾的 {{ if newYear ... }} 实际用于匹配「当前项年份变更」后闭合前一年的
。更健壮的做法是在 Go 层预处理为嵌套结构（如 map[string][]Post），但本方案完全在模板层完成，零结构改造，适合轻量归档。
✅ 完整可运行示例（精简版）
Playground 示例 验证了上述逻辑。关键点总结：
- 排序必须在 Go 层完成，模板不支持 sort；
- newYear 函数依赖闭包状态，不可跨请求复用；
- Format "2006" 是 Go time 格式化标准写法（代表年份，因 Go 纪元始于 2006-01-02）；
- 若需支持多语言月份/星期，应使用 time.LoadLocation 和 (*time.Time).In().Format() 配合本地化布局。
掌握此模式后，你不仅能实现「按年分组+逆序」，还可轻松扩展为「按年月分组」「按标签聚合」等场景——核心思想始终是：排序交由 Go，分组逻辑借力闭包函数，模板专注声明式渲染。
