Go 模板中 range 循环内无法修改外部声明的变量：原因与解决方案_技术教程

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