
go模板无法访问结构体中未导出(小写首字母)的字段,需将切片字段改为大写首字母导出,并在模板中使用对应导出名。
在 Go 的 text/template 包中,模板引擎仅能访问导出(exported)的字段——即首字母为大写的字段。这是 Go 语言的反射机制与模板安全策略共同决定的行为。若结构体字段以小写字母开头(如 people),即使其类型正确、数据已赋值,模板执行时也会静默忽略该字段,导致 range 循环不触发、输出为空。
以下为修正后的完整可运行示例:
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-example").Parse(`
{{range $i, $p := $.People}}
[{{$i}}] Name={{$p.Name}}, Senior={{$p.Senior}}
{{end}}
`))
if err := t.Execute(os.Stdout, ctx); err != nil {
panic(err)
}
}预期输出:
[0] Name=Mary, Senior=false [1] Name=Joseph, Senior=true
? 关键要点总结:
- 模板中所有待访问的结构体字段(包括嵌套结构体中的字段)必须导出(大写首字母);
- 模板内引用路径需严格匹配导出名(如 $.People,而非 $.people);
- range 语法 {{range $index, $item := $.Slice}} 是标准用法,无需额外修改;
- 若需调试字段可见性,可临时在模板中添加 {{printf "%#v" .}} 查看实际传入的数据结构;
- 切片本身无需特殊标记,只要其所属字段导出且类型可被模板解析即可。
遵循导出规则是 Go 模板正常工作的前提,也是保障代码封装性与模板安全性的重要设计。










