17370845950

在 go 模板中，`{{ $var := value }}` 在 `range` 内部重新声明变量会创建同名新作用域变量，而非修改外层变量；go 1.11+ 虽支持 `{{ $var = value }}` 赋值，但旧版本必须通过函数、方法或结构化数据预处理实现状态传递。

Go 模板的设计遵循词法作用域（lexical scoping）原则：每个 {{ ... }} 块（尤其是控制结构如 range、if）内部通过 := 声明的变量仅在该块内有效，且会遮蔽（shadow）外层同名变量。因此，以下代码无法实现“跨迭代记忆上一个日期”的预期逻辑：

{{ $prevDate := "" }}
{{ range $post := .Posts }}
    {{ if ne $prevDate $post.Date }}
        Posts dated: {{ $post.Date }}
    {{ end }}
    {{ $post.Content }}
    {{ $prevDate := $post.Date }}  
{{ end }}

这里 $prevDate := $post.Date 并未修改外层 $prevDate，而是在每次循环中新建一个仅作用于本次迭代的局部变量，导致外层变量始终为初始值 ""。

✅ 正确解决方案（兼容 Go 1.10 及更早版本）

方案一：使用模板函数（推荐，清晰解耦）

注册一个辅助函数，接收当前索引并返回前一项日期：

// 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 }}`))

✅ 优点：逻辑复用性强，模板简洁；❌ 缺点：需在 Go 层注册，增加上下文依赖。

方案二：为数据结构添加方法（类型安全首选）

为 Posts 切片类型定义方法，直接在模板中调用：

type Post struct {
    Date    string
    Content string
}

type Posts []Post

func (ps Posts) PrevDate(i int) string {
    if i <= 0 || i >= len(ps) {
        return ""
    }
    return ps[i-1].Date
}

模板中使用（注意 $.Posts 引用根数据中的 Posts 字段）：

{{ range $i, $post := .Posts }}
    {{ $prevDate := $.Posts.PrevDate $i }}
    {{ if ne $prevDate $post.Date }}
        Posts dated: {{ $post.Date }}
    {{ end }}
    {{ $post.Content }}
{{ end }}

✅ 优点：零注册、强类型、易于测试；❌ 注意：方法接收者应为值类型 Posts（非指针），避免模板中意外修改原始数据。

方案三：预处理数据（最高效，推荐生产环境）

在 Go 后端将状态逻辑前置，构造带 IsNewDay 标志的视图模型：

type PostView struct {
    Post      Post
    IsNewDay  bool
}

func buildPostViews(posts []Post) [
]PostView {
    views := make([]PostView, 0, len(posts))
    var prevDate string
    for _, p := range posts {
        views = append(views, PostView{
            Post:     p,
            IsNewDay: p.Date != prevDate,
        })
        prevDate = p.Date
    }
    return views
}

模板简化为：

{{ range .PostViews }}
    {{ if .IsNewDay }}
        Posts dated: {{ .Post.Date }}
    {{ end }}
    {{ .Post.Content }}
{{ end }}

✅ 优点：模板无逻辑、性能最优、可读性最强；❌ 缺点：需额外数据转换层。

⚠️ 注意事项与最佳实践

• Go 1.11+ 赋值语法：若确定最低运行环境为 Go 1.11+，可直接使用 {{ $prevDate = $post.Date }}（单等号），但需确保变量已在外层声明（:= 仅用于首次声明）。
• 避免副作用：模板应保持纯函数式——不修改传入数据，所有状态变化应在 Go 层完成。
• 作用域陷阱：range、with、if 等块内 := 均创建新作用域，如需跨块共享，务必通过函数、方法或预处理实现。
• 性能提示：方案三（预处理）在大数据量时显著优于方案一/二，因避免了模板内重复计算。

综上，优先选择预处理数据（方案三），兼顾可维护性、性能与模板纯净性；若需动态逻辑，再选用方法或函数方案，并始终明确作用域边界。