Go 中 HTML 模板访问结构体字段的正确方法：导出字段是关键

在 go 的 `html/template` 中，只有首字母大写的导出字段才能被模板访问；小写字段（如 `desc`）因未导出而无法在模板中通过 `{{.desc}}` 访问，需改为 `desc` 并同步更新初始化和模板引用。

Go 的模板引擎遵循 Go 语言的可见性规则：只有导出（exported）标识符（即首字母大写的字段、方法或类型）才能在模板中被访问。你定义的 Task 结构体中，cmd、args 和 desc 均为小写开头，属于未导出字段，因此即使它们在结构体内存在，html/template 在执行时会静默忽略对 {{$value.desc}} 的访问，不报错但也不渲染值。

✅ 正确做法是将需暴露给模板的字段改为导出形式：

type Task struct {
    Cmd  string   // 导出字段，模板中用 .Cmd
    Args []string // 导出字段，模板中用 .Args
    Desc string   // 导出字段，模板中用 .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 matching 'foo'",
    },
}

模板 index.tmpl 中相应调整字段引用（注意大小写匹配）：

Frase

Frase是一款出色的长篇 AI 写作工具，快速创建seo优化的内容。

下载

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

{{range $key, $value := .}}
  
Task Name:        {{$key}}
  
Task Command:     {{$value.Cmd}}
  
Task Arguments:   {{join $value.Args " "}}
  
Task Description: {{$value.Desc}}
{{end}}

? 提示：{{join $value.Args " "}} 需要自定义 join 函数（通过 template.Funcs 注册），或改用 {{range $value.Args}}{{.}} {{end}} 实现空格分隔。若仅需简单展示，可直接用 {{printf "%q" $value.Args}}。

⚠️ 注意事项：

• 字段名大小写必须严格匹配，desc 和 Desc 是两个完全不同的字段；
• 方法同理：只有导出方法（如 func (t Task) String() string）才能在模板中调用 {{.String}}；
• 模板中访问嵌套结构体字段（如 {{.Parent.Child.Field}}）时，每一级都必须是导出字段；
• 若结构体来自第三方包且无法修改，可考虑封装一层导出字段的适配器结构体，或使用 map[string]interface{} 中转（但会损失类型安全）。

总结：Go 模板不是“反射黑盒”，而是严格遵守语言导出规则的轻量视图层。让字段可被模板读取，本质就是让它对包外可见——这是 Go “显式优于隐式”哲学的直接体现。