
在 go 模板中,`{{ $var := value }}` 在 `range` 内部会**重新声明同名变量**而非赋值,导致其作用域仅限当次迭代,无法跨循环更新状态。go 1.11+ 支持 `{{ $var = value }}` 赋值语法,但旧版本需通过索引函数或方法绕过限制。
Go 模板的变量作用域规则是理解该问题的关键:模板中所有 := 都是变量声明(declaration),而非赋值(assignment)。这意味着:
- {{ $prevdate := “” }} 在 range 外声明了一个 $prevDate 变量,作用域覆盖整个模板;
- 但在 range 内部再次写 {{ $prevDate := $post.Date }},实际是在当前 range 迭代作用域内新建一个同名局部变量,它屏蔽(shadow)了外层变量,且生命周期仅到 {{ end }} 结束;
- 下一次迭代时,该局部变量已销毁,外层 $prevDate 从未被修改,仍为初始值 “”。
✅ 正确方案(兼容 Go
方案一:使用索引 + 自定义函数(推荐)
注册一个辅助函数,在模板中根据当前索引获取前一项日期:
// Go 代码:注册函数 func prevDate(posts []Post, i int) String { if i <= 0 || i >= len(posts) { return "" } return posts[i-1].Date } tmpl := template.Must(template.New("blog"). Funcs(map[string]interface{}{ "PrevDate": prevDate, }). Parse(`{{ range $i, $post := .Posts }} {{ $prevDate := PrevDate $.Posts $i }} {{ if ne $prevDate $post.Date }} Posts dated: {{ $post.Date }} {{ end }} {{ $post.Content }} {{ end }}`))
⚠️ 注意:函数参数顺序需与模板调用一致(PrevDate $.Posts $i),$.Posts 确保传入原始切片。
方案二:为数据结构添加方法
更面向对象的方式——为 Posts 类型添加 PrevDate(i int) 方法:
type Post struct { Content string Date string } type Posts []Post func (p Posts) PrevDate(i int) string { if i <= 0 || i >= len(p) { return "" } return p[i-1].Date }
模板中直接调用:
{{ range $i, $post := .Posts }} {{ $prevDate := $.Posts.PrevDate $i }} {{ if ne $prevDate $post.Date }} Posts dated: {{ $post.Date }} {{ end }} {{ $post.Content }} {{ end }}
✅ Go 1.11+ 原生支持(简洁但需版本保障)
若项目可升级至 Go 1.11 或更高版本,可直接使用赋值语法 =(非 :=):
{{ $prevDate := "" }} {{ range $post := .Posts }} {{ if ne $prevDate $post.Date }} Posts dated: {{ $post.Date }} {{ end }} {{ $post.Content }} {{ $prevDate = $post.Date }} {{/* 注意:此处是 =,不是 := */}} {{ end }}
✅ 此时 $prevDate = … 是真正的变量更新,作用域保持不变,可跨迭代生效。
总结
- 根本原因::= 是声明,非赋值;range 每次迭代创建新作用域,内部声明会遮蔽外层变量。
- 向后兼容首选:使用带索引的 range + 自定义函数或类型方法,逻辑清晰、易于测试。
- 现代写法:确认 Go 版本 ≥ 1.11 后,优先采用 {{ $var = value }} 语法,大幅简化模板逻辑。
- 额外提示:避免在模板中处理复杂逻辑;日期分组等聚合操作建议提前在 Go 代码中完成(如按天分组为 map[string][]Post),再传入模板,更高效且易维护。