Go模板中在子块/Range内如何访问全局作用域数据？

问题场景 #

在Go模板的range循环或子模板块中，尝试访问顶层传入的全局变量（比如示例中的allUsers）时，会出现上下文错误——因为此时模板中的.指向的是当前循环的对象（如Group实例），而非顶层的全局数据。

后端代码示例 #

type User struct {
    UserId   string
    Username string
}

type Group struct {
    GroupName    string
    GroupMembers []User // 修正原代码的[]Users类型错误
}

func GroupDetails(w http.ResponseWriter, r *http.Request) {
    data := map[string]any{}
    var tGroups []Group
    var tUsers []User 
    
    tGroups = LoadGroupsFromDatabase() // 修正重复声明语法错误
    tUsers = LoadUsersFromDatabase()

    data["groups"] = tGroups // 修正键名拼写与引号格式错误
    data["allUsers"] = tUsers

    myTemplate, err := template.ParseFiles("templates/groups.tmpl")
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
        return
    }
    err = myTemplate.ExecuteTemplate(w, "groups", data)
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
    }
}

原模板代码及错误 #

原模板代码 #

{{ block "groups" . }}
{{ template "AllUsers" .allUsers }} <!-- 此处正常工作 -->
{{ range .groups }}
  {{ template "GroupDetails" . }} 
{{ end }} <!-- end groups range -->
{{ end }} <!-- end block --> 

{{ block "GroupDetails" . }}
Group name : {{ .GroupName }}
  Group members :
  {{ range .GroupMembers }}
     {{ UserName }} <!-- 错误：访问属性需加.前缀 -->
  {{ end }} <!-- end range group members -->  
  Add users:
  {{ template AllUsers $.allUsers }} <!-- 错误：模板名需加引号，且$指向当前Group而非顶层 -->
{{ end }}

{{ block "AllUsers" . }}
  {{ range . }}
    {{ UserName }} <!-- 错误：访问属性需加.前缀 -->
  {{ end }}
{{ end }} 

报错信息 #

executing "groups" at <$.allUsers>: can't evaluate field allUsers in type *Group

解决方案 #

核心思路是在调用子模板时，主动将全局变量传递进去，避免被子块的局部上下文覆盖。

方案1：通过字典封装传递数据 #

修改groups块中调用子模板的逻辑，用dict将当前Group对象和全局allUsers打包传递：

{{ block "groups" . }}
{{ template "AllUsers" .allUsers }}
{{ range .groups }}
  <!-- 用dict封装当前Group和全局用户列表 -->
  {{ template "GroupDetails" (dict "CurrentGroup" . "GlobalUsers" $.allUsers) }}
{{ end }}
{{ end }}

然后修改GroupDetails块，从传入的字典中读取对应数据：

{{ block "GroupDetails" . }}
Group name : {{ .CurrentGroup.GroupName }}
  Group members :
  {{ range .CurrentGroup.GroupMembers }}
     {{ .Username }} <!-- 修正属性访问语法 -->
  {{ end }}
  Add users:
  {{ template "AllUsers" .GlobalUsers }} <!-- 使用传递的全局用户列表 -->
{{ end }}

方案2：提前保存全局变量到模板变量 #

在顶层块中先将全局变量赋值给一个模板变量，后续在range内直接复用该变量：

{{ block "groups" . }}
{{ $globalUsers := .allUsers }} <!-- 保存全局用户列表到模板变量 -->
{{ template "AllUsers" $globalUsers }}
{{ range .groups }}
  {{ template "GroupDetails" (dict "CurrentGroup" . "GlobalUsers" $globalUsers) }}
{{ end }}
{{ end }}

GroupDetails块的修改同方案1即可。

额外修正点 #

• 模板中访问对象属性必须以.开头，比如{{ .Username }}而非{{ Username }}；
• 调用模板时，模板名称必须用双引号包裹，比如{{ template "AllUsers" . }}而非{{ template AllUsers . }}。

内容的提问来源于stack exchange，提问作者parasit