本文介绍如何在 go 模板中对时间戳数据（如博客文章发布时间）进行逆序排序，并按年份自动分组渲染，避免重复年标题，同时保持语义清晰与 html 结构合理。
本文介绍如何在 go 模板中对时间戳数据（如博客文章发布时间）进行逆序排序，并按年份自动分组渲染，避免重复年标题，同时保持语义清晰与 html 结构合理。
在构建博客或内容归档页面时，常见的需求是将文章按发布年份分组、每组内按时间倒序排列（即最新文章在前），并为每个年份仅渲染一次标题（如
2023
）。Go 的 html/template 本身不支持原生的分组或复杂状态追踪，因此需结合 Go 代码预处理与模板函数协同实现。✅ 步骤一：实现 sort.Interface 并逆序排序
首先，需确保 Posts（或类似容器）类型实现了 sort.Interface，以便调用 sort.Sort(sort.Reverse(...)) 实现降序排列。关键在于 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 使用 Before 是升序逻辑，此处已修正为 After，才能实现真正的逆序（最新优先）。若保留 Before，需配合 sort.Reverse，但更直观、不易出错的方式是直接在 Less 中表达“i 应排在 j 前面”的语义。
排序调用示例：
posts := Posts{YourPostSlice}
sort.Sort(posts) // 已按 PostDate 从新到旧排序✅ 步骤二：注入带状态的模板函数实现年份分组
由于模板无法维护跨 range 迭代的状态，需借助闭包函数在 Go 层动态生成一个“记忆上次年份”的函数，并注册为 template.FuncMap：
currentYear := ""
funcMap := template.FuncMap{
"isNewYear": func(t time.Time) bool {
year := t.Format("2006")
if year != currentYear {
currentYear = year
return true
}
return false
},
}
tmpl := template.Must(template.New("archive").Funcs(funcMap).Parse(archiveTmpl))该函数返回 true 仅当遇到新一年份，可用于条件渲染年标题。
✅ 步骤三：模板中按需渲染年标题与条目
在模板中，结合 range 和 isNewYear 函数即可优雅分组：
{{ range .Posts }}
{{ if isNewYear .PostDate }}
<h2>{{ .PostDate.Format "2006" }}</h2>
<ul>
{{ end }}
<li>{{ .PostDate.Format "2006 Jan 02" }} » <a href="{{ .URL }}">{{ .Title }}</a></li>
{{ if isNewYear .PostDate }}
</ul>
{{ end }}
{{ end }}? 提示：为确保每组末尾 闭合，上述写法依赖 isNewYear 在首次命中时触发开标签，后续同组条目不再触发。若需更高鲁棒性（如空切片、单条目边界），可改用 {{ $first := true }}{{ range $i, $p := .Posts }}{{ if isNewYear $p.PostDate }}...{{ end }}{{ end }} 模式，但当前方案简洁且满足常规场景。
? 总结与最佳实践
- 排序必须在 Go 层完成：模板不具备排序能力，且 sort.Reverse 需配合正确 Less 实现；
- 状态管理交由 Go 逻辑：通过闭包函数注入模板，比尝试在模板中用 $.First 或索引判断更可靠；
- 格式化统一使用 time.Time 方法：如 "2006" 表示年份，避免字符串解析错误；
-
HTML 语义建议：年标题推荐用
或
，条目用
- /
- ，符合无障碍与 SEO 规范。
完整可运行示例见 Go Playground（已更新为修正版逻辑）。掌握此模式后，亦可轻松扩展为“按年/月”两级分组或添加年份摘要统计。
