本文讲解如何在 Go 的 HTML 模板中对时间戳数组进行逆序排序，并按年份自动分组渲染（如“2009”标题下聚合该年所有文章），全程无需预处理数据，仅通过自定义 sort.Interface 和模板函数即可实现。
本文讲解如何在 go 的 html 模板中对时间戳数组进行逆序排序，并按年份自动分组渲染（如“2009”标题下聚合该年所有文章），全程无需预处理数据，仅通过自定义 `sort.interface` 和模板函数即可实现。
在构建博客或内容归档页时，按年分组展示文章是常见需求。原始数据若按时间无序排列，直接遍历模板会破坏逻辑结构；而若依赖后端提前分组，则丧失模板层的灵活性。Go 标准库提供了优雅的解决方案：结合 sort.Interface 实现逆序排序 + 模板函数动态识别年份边界，完全在渲染阶段完成结构化输出。
✅ 步骤一：为 Posts 实现 sort.Interface（支持逆序）
首先，让 Posts 类型满足 sort.Interface 接口，使其可被 sort.Sort() 调用。注意 Less() 方法返回 i 逆序（最新在前），则应判断 i 的时间是否 晚于 j 的时间：
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.After(p.Posts[j].PostDate) }
func (p Posts) Swap(i, j int) { p.Posts[i], p.Posts[j] = p.Posts[j], p.Posts[i] }⚠️ 关键点：Less(i,j) 定义的是“是否应将 i 排在 j 前面”。After() 确保较新的日期排在前面，从而实现自然的倒序（2024 → 2023 → …）。
排序调用：
posts := Posts{yourPostSlice}
sort.Sort(posts) // 已按 PostDate 降序排列✅ 步骤二：注册模板函数 newYear 实现年份分组
单纯排序还不够——还需在模板中识别“新一年的开始”。由于 Go 模板不支持状态变量，我们使用闭包函数注入方式维护上一个年份：
currentYear := ""
funcMap := template.FuncMap{
"newYear": func(yearStr string) bool {
if yearStr == currentYear {
return false // 同一年，不输出标题
}
currentYear = yearStr
return true // 新年份，需输出 <h1>
},
}
tmpl := template.Must(template.New("archive").Funcs(funcMap).Parse(...))✅ 步骤三：模板中按年渲染（简洁清晰）
在 HTML 模板中，利用 newYear 函数控制标题输出，并保持列表结构语义正确：
{{ range .Posts }}
{{ if newYear (.PostDate.Format "2006") }}
<h2>{{ .PostDate.Format "2006" }}</h2>
<ul>
{{ end }}
<li>{{ .PostDate.Format "2006 Jan 02" }}»<a href="{{ .URL }}">{{ .Title }}</a></li>
{{ if newYear (.PostDate.Format "2006") }}
</ul>
{{ end }}
{{ end }}? 提示：newYear 在 range 中被多次调用，闭包内部的 currentYear 会持续更新，确保每个年份标题仅出现一次，且紧跟其首条记录。
? 完整工作示例（Playground 验证）
你可以在 Go Playground 示例 中直接运行验证：输入乱序的 Post 切片，输出严格按年降序分组的 HTML 结构，无冗余、无遗漏。
✅ 总结
- 排序靠接口：实现 Len/Less/Swap 是 Go 模板外排序的核心；
- 分组靠闭包：模板函数通过闭包持有状态，规避了模板语法限制；
-
语义靠结构：
+
- 组合保证生成符合可访问性（a11y）与 SEO 的语义化 HTML；
- 零耦合设计：业务逻辑（时间比较）、视图逻辑（分组渲染）完全解耦，易于测试与复用。
此方案兼顾性能（单次排序）、可读性（模板逻辑直白）与扩展性（如后续增加“季度分组”只需修改 newYear 的格式字符串），是 Go Web 渲染场景下的典型最佳实践。
