Gin 模板无法修改绑定数据，因其基于 Go html/template，仅支持单向只读渲染；所有数据须由 handler 显式传入且冻结，赋值、作用域劫持等操作均不被支持。
不能直接在模板中“改变”绑定数据的作用域；Gin 的 HTML 模板是只读渲染层，所有数据必须由 handler 显式传入，且传入后不可修改。
为什么模板里改不了绑定的数据
Gin 使用的是 Go 标准库 html/template，它在执行时只做单向数据展开（{{.FieldName}} 或 {{.}}），不支持运行时赋值、变量重绑定或作用域劫持。所谓“绑定数据”，只是 handler 调用 c.HTML() 时把一个 Go 值（如 gin.H、结构体指针）作为 data 参数传给模板引擎——这个值在模板执行期间是冻结的。
常见误解场景：
- 写
{{$.User.Name = "new"}}→ 模板语法错误，Go 模板不支持赋值操作符 - 试图在
{{range}}中修改外层变量 → range 会创建新作用域，且原数据不可变 - 以为
{{with .User}}能“切换并持久化”作用域 →with只是临时限定当前块的作用域，不影响传入数据本身
想让模板“看起来像变了数据”，得靠 handler 重新组织
真正可控的入口只有 handler：你需要在调用 c.HTML() 前，把最终要渲染的数据准备好。比如：
- 原始数据是
user.User，但模板需要显示脱敏邮箱 → 在 handler 里构造新字段：data := gin.H{"displayEmail": maskEmail(user.Email), "user": user} - 需要根据权限动态展示按钮 → 不在模板里 if/else 判断权限，而是在 handler 里算好布尔值：
"canEdit": user.Role == "admin" - 想让子模板复用同一份用户信息但不同格式 → 提前转成多个视图模型（view model），而不是指望模板转换
错误做法：c.HTML(200, "profile.html", user) 然后幻想模板能自己加工 user.Email；正确做法：c.HTML(200, "profile.html", gin.H{"user": user, "maskedEmail": user.MaskedEmail()})。
template.FuncMap 是唯一能在模板里“计算”的出口
如果某些简单转换（如日期格式化、字符串截断）反复出现，可以注册自定义函数，但它仍是只读计算，不改变原始数据：
r.SetFuncMap(template.FuncMap{
"truncate": func(s string, n int) string {
if len(s) > n {
return s[:n] + "..."
}
return s
},
})
然后在模板中用：{{truncate .Bio 50}}。注意：
- 函数接收的是副本，无法修改传入的 struct 字段
- 函数必须在
r.LoadHTMLGlob()之前注册，否则无效 - 避免在 FuncMap 里做 DB 查询、HTTP 调用等副作用操作——模板渲染应是纯函数式
最易被忽略的一点：很多人花半天调试模板里的 {{if .Items}}{{range .Items}}{{.Name}}{{end}}{{end}}，却没意识到 .Items 为空是因为 handler 忘了初始化切片（[]Item{} vs nil），而不是模板“没绑对”。数据流永远是从 handler → 模板，单向且不可逆。
