如何在 Go 的 html/template 中访问 map 中结构体字段？

在 go 模板中访问 map 值的结构体字段时，必须将结构体字段导出（首字母大写），否则模板引擎无法反射读取；本文详解导出规则、代码修改步骤及完整工作示例。

go 的 html/template 包通过反射机制访问数据字段，而 Go 的反射仅能访问导出（exported）字段——即首字母为大写的字段。你原始定义的 Task 结构体中，cmd、args 和 desc 均为小写开头的非导出字段，因此 {{$value.desc}} 在模板中会静默失败（输出空值），且无编译或运行时错误提示，极易造成排查困难。

✅ 正确做法是将需在模板中使用的字段改为导出字段。例如，将 desc 改为 Desc，并同步更新初始化代码和模板引用：

type Task struct {     Cmd  String   // 导出字段，模板可访问     Args []string // 导出字段     Desc string   // 导出字段（原 desc → Desc） }

对应地，初始化 taskMap 时也需使用导出字段名：

var taskMap = map[string]Task{     "find": Task{         Cmd:  "find",         Args: []string{"/tmp/"},         Desc: "find files in /tmp dir",     },     "grep": Task{         Cmd:  "grep",         Args: []string{"foo", "/tmp/*", "-R"},         Desc: "grep files match having foo",     }, }

模板文件 index.tmpl 中亦须使用大写字段名：

立即学习“前端免费学习笔记（深入）”；

 {{range $key, $value := .}}   
Task Name:        {{$key}}
   
Task Value:       {{$value}}
   
Task description: {{$value.Desc}}
 {{end}} 

⚠️ 注意事项：

• 仅导出所需字段即可，避免过度暴露内部结构；
• 字段名变更后，所有引用处（结构体定义、初始化、模板）必须保持一致；
• 若需访问嵌套结构体字段（如 {{$value.Config.Timeout}}），其路径上每个字段都必须导出；
• 模板中调用方法（如 {{$value.String()}}）同样要求该方法为导出方法（首字母大写）。

通过以上调整，模板即可正确渲染结构体字段。此机制是 Go 安全模型的一部分，确保模板无法意外访问私有状态，开发者需主动设计“模板友好”的数据契约。