Beego 模板中在 range 循环内访问外部作用域变量的正确方法

在 Beego 模板里，用 {{range}} 循环时，有个坑特别容易踩：当前作用域会切换到迭代项上，比如 *models.Foo，这时候你想直接访问 .user 这种父级数据？抱歉，根本找不到。正确的姿势是，用 $.user 显式引用根作用域变量。

举个典型场景：你在控制器里往模板传了多个变量，比如 c.Data["foos"] = foos 和 c.Data["user"] = user。此时模板的根作用域（也就是 $）包含了所有这些键值对。但一旦进入 {{range $foo := .foos}}，. 就被重新绑定为当前迭代的 foo 实例（类型是 *models.Foo），.user 自然就不存在了——报错信息很明确：“user is not a field of struct type *models.Foo”。

所以，解决方案其实很简单：使用 $ 来访问根作用域。$ 始终指向最外层的 .Data 映射，因此 $.user 可以安全地拿到原始 user 对象。

来看看修正后的代码长什么样：

{{range $foo := .foos}}      {{if $.user.IsSuperUser}}      {{$.user.ID}}      {{$.user.Username}}      {{$.user.Email}}    {{else}}      {{$.user.Username}}    {{end}}    {{$.user.CreatedAt | date "2006-01-02"}}  {{end}}

注意事项

• $.user 中的 $ 是固定语法，代表模板根作用域，不能省略，也不能替换成其他符号。
• 如果嵌套多层（比如 range 里再套 with），照样可以用 $ 访问顶层数据，不需要逐级回溯。
• 别写错：..user 在 Go 模板里根本不存在；$.foos.user 逻辑上也不对——foos 是个切片，不包含 user 字段。
• 在复杂模板里，推荐统一使用命名变量（比如 {{range $index, $foo := .foos}}），并配合 $ 访问外部数据，这样可读性和可维护性都更好。

总结一下：{{range}} 会改变 . 的绑定对象，但 $ 始终稳定地指向初始数据上下文。这是 Go 模板语言的标准机制，在 Beego、Hugo、Gin 等所有基于 html/template 的框架里都通用。