17370845950

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 类型可见性模型在模板层的严格体现。