go模板无法遍历结构体中未导出字段（小写首字母），必须将字段名改为大写字母开头使其可导出，才能在text/template中正常访问并range遍历。
在 Go 的 text/template 包中，模板引擎仅能访问结构体的导出字段（即首字母大写的字段）。这是 Go 语言反射机制和模板安全设计的基本约束——未导出字段（如 people）对 template 包不可见，因此 {{range $.people}} 不会报错，但也不会执行任何迭代，最终输出为空。
✅ 正确做法：确保字段导出
将 Context 结构体中的 people 字段改为导出字段（首字母大写）：
type Context struct {
People []Person // ✅ 导出字段：首字母 'P' 大写
}同时，模板中需同步更新为 $.People：
tRange = templ.Must(tRange.Parse(`
{{range $i, $x := $.People}}
Name={{$x.Name}} Senior={{$x.Senior}}
{{end}}
`))? 完整可运行示例
package main
import (
"os"
"text/template"
)
type Context struct {
People []Person // 注意：必须大写导出
}
type Person struct {
Name string // 导出字段，模板可读
Senior bool
}
func main() {
ctx := Context{
People: []Person{
{Name: "Mary", Senior: false},
{Name: "Joseph", Senior: true},
},
}
t := template.Must(template.New("range").Parse(`
{{range $i, $x := $.People}}
[{{$i}}] Name={{$x.Name}}, Senior={{$x.Senior}}
{{end}}
`))
t.Execute(os.Stdout, ctx)
}预期输出：
[0] Name=Mary, Senior=false [1] Name=Joseph, Senior=true
⚠️ 注意事项
- range 中的 $i, $x 是可选的：若只需值，可用 {{range $.People}} {{$x.Name}} {{end}}（此时 $x 即当前项，无需显式声明索引）；
- 模板内所有字段访问路径（如 $.People, $x.Name）都依赖于对应结构体字段是否导出；
- 嵌套结构体同理：若 Person 内含非导出字段（如 age int），即使 Name 可读，$x.age 也会静默失效；
- 使用 template.Must() 可在解析失败时 panic，便于开发期快速定位语法错误（如字段名拼写错误）。
掌握导出规则是 Go 模板开发的基础前提——它不是语法糖，而是 Go 类型可见性模型在模板层的严格体现。
