本文详解如何在Go模板中通过{{range}}语法遍历嵌套结构体（如ThemeList.Themes切片），并安全访问其内层字段（如.Name、.Tag），避免常见作用域错误。
本文详解如何在go模板中通过`{{range}}`语法遍历嵌套结构体（如`themelist.themes`切片），并安全访问其内层字段（如`.name`、`.tag`），避免常见作用域错误。
在Go的html/template或text/template中，遍历嵌套结构体的关键在于
明确数据上下文的传递路径
。以ThemeList为例，其本身是一个容器结构体，而实际需迭代的是其字段Themes []Theme——这是一个切片，而非顶层数据对象。因此，模板不能直接写{{range .}}（这会尝试遍历ThemeList的字段），而必须显式指向切片路径：{{range .Themes}}。
此时，range的作用域会自动切换为当前Theme实例，后续所有点号访问（如.Name、.Tag）均基于该Theme结构体，无需前缀。完整模板示例如下：
⚠️
关键注意事项
：
模板执行时，传入的数据必须是*ThemeList（指针）或ThemeList值类型，但
推荐传指针
——既避免复制大结构体，也确保xml.Unmarshal等操作的兼容性；
Theme结构体字段必须首字母大写（即导出字段），否则模板无法访问（Go模板仅能访问导出字段）；
若XML解析失败导致Themes为空切片，{{range}}将静默跳过，不会报错，建议在业务逻辑中预先校验数据完整性；
如需在循环内访问父级上下文（例如显示总主题数），可使用$符号引用根对象：{{len $.Themes}}个主题。
最后，结合你的openXML函数，模板渲染应如下组织：
掌握这一模式后，无论结构嵌套多深（如A.B.C.Ds），只需在模板中逐级写出路径即可安全遍历——核心原则始终不变：range后指定切片路径，循环体内直接访问元素字段。
{{range .Themes}}
- {{.Name}} — Tag: {{.Tag}} | Page: {{.Page}} | Day: {{.Day}}
{{end}}
t := openXML("themes.xml") // 返回 ThemeList 值类型
tmpl := template.Must(template.New("list").Parse(`{{range .Themes}}- {{.Name}} ({{.Tag}})
{{end}}
`))
err := tmpl.Execute(os.Stdout, &t) // 注意：传入 &t（指针）
if err != nil {
log.Fatal(err)
}