在 Beego 模板中使用 {{range}} 时,当前作用域会切换为迭代项(如 *models.Foo),导致 .user 等外层变量无法直接访问;需通过 $.user 显式引用根作用域下的数据。
在 beego 模板中使用 `{{range}}` 时,当前作用域会切换为迭代项(如 `*models.foo`),导致 `.user` 等外层变量无法直接访问;需通过 `$.user` 显式引用根作用域下的数据。
当你在控制器中设置多个数据:
c.Data["foos"] = foos c.Data["user"] = user
模板中可直接使用 {{.user.IsSuperUser}} —— 这是因为顶层作用域(即 c.Data 映射)下存在 user 字段。但一旦进入 {{range $foo := .foos}},模板的作用域便切换为每个 foo 实例(类型为 *models.Foo),此时 {{.user}} 就会被解释为 “从 *models.Foo 结构体中查找 user 字段”,而该结构体显然不含此字段,因此报错:
executing "content" at <.user.issuperuser>: user is not a field of struct type *models.Foo
✅ 正确解法:使用 $ 符号访问根作用域(root scope),即最初传入模板的完整数据上下文。
修改你的模板代码如下:
<tbody>
{{range $foo := .foos}}
<tr>
{{if $.user.IsSuperUser}}
<td>xyz</td>
<td>abc</td>
{{else}}
<td>{{$.user.Username}}</td>
{{end}}
<td>{{$foo.Name}}</td>
<td>{{$foo.ID}}</td>
</tr>
{{end}}
</tbody>
? 关键说明:
- $ 始终指向最外层数据对象(等价于 c.Data 的映射结果);
- $.user 表示从根作用域读取 user 变量,与当前 range 迭代项无关;
- $.foos 同理可用,但通常在 range 内直接用 {{$foo}} 更清晰;
- 此规则同样适用于 {{with}}、嵌套 {{template}} 等改变作用域的语句。
⚠️ 注意事项:
- 不要误写为 {{$.user.IsSuperUser}} 在 {{with .user}} 内部再嵌套 range —— 此时需根据嵌套层级判断是否还需加 $(一般一层 $ 即可回到根);
- Beego 使用 Go 标准 html/template,其作用域规则与原生 Go 模板完全一致,无框架特有语法;
- 若需频繁访问外层变量,也可考虑在控制器中预先合并数据(如 c.Data["ctx"] = map[string]interface{}{"user": user, "foos": foos}),然后统一用 $.ctx.user 访问,提升可读性。
掌握 $ 的用法,是编写健壮、可维护 Beego 模板的关键基础。











