
在 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),再传入模板,更高效且易维护。









