在 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 的框架里都通用。