Beego模板range访问外层变量方法

在 Beego 模板中使用 `{{range}}` 时，作用域会切换到迭代项导致外层变量（如 `.user`）无法直接访问，容易引发“field not found”错误；本文详解了通过 `$` 符号显式引用根作用域（即控制器传入的 `c.Data` 上下文）这一关键技巧，用 `$.user` 安全访问顶层数据，并延伸说明其在 `{{with}}`、嵌套模板等场景的通用性，同时提供预合并数据等实用优化建议——掌握 `$`，是写出清晰、健壮、可维护 Beego 模板的必备基础。

在 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 模板的关键基础。

今天带大家了解了的相关知识，希望对你有所帮助；关于Golang的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~