本文介绍如何从 Go 的 text/template 或 html/template 对象中静态提取所有模板中显式引用的结构体字段名（如 {{.title}} 中的 title），适用于参数校验、动态数据准备和模板元信息分析等场景。
本文介绍如何从 go 的 `text/template` 或 `html/template` 对象中静态提取所有模板中显式引用的结构体字段名（如 `{{.title}}` 中的 `title`），适用于参数校验、动态数据准备和模板元信息分析等场景。
Go 标准库的 template 包本身不提供直接获取参数列表的公开 API，但可通过解析其内部抽象语法树（AST）——即 parse.Tree ——来实现字段提取。该树由 template.Parse() 构建，完整描述了模板的结构，其中所有 {{.xxx}} 形式的字段访问均以 *parse.FieldNode 节点形式存在。
以下是一个完整、健壮的实现示例，支持递归遍历 AST 并收集所有顶层结构体字段（即 .Xxx 中的 Xxx），忽略嵌套作用域（如 {{range .Items}}{{.Name}}{{end}} 中的内层 .Name）或方法调用（如 .Method()）：
package main
import (
"fmt"
"reflect"
"text/template"
"text/template/parse"
)
// extractFieldNames 从 template.Tree 中提取所有顶层字段名（如 {{.Title}} → "Title"）
func extractFieldNames(t *template.Template) []string {
var fields []string
trees := t.Templates()
if len(trees) == 0 {
return fields
}
// 遍历每个模板（一个 template 可含多个命名模板）
for _, tree := range trees {
walkNode(tree.Root, func(node parse.Node) {
if fieldNode, ok := node.(*parse.FieldNode); ok {
// 仅提取顶层字段：节点路径长度为 2（即 "." + 字段名），且第一个标识符是 "."
if len(fieldNode.Ident) >= 2 && fieldNode.Ident[0] == "." {
fieldName := fieldNode.Ident[1]
// 去重
if !contains(fields, fieldName) {
fields = append(fields, fieldName)
}
}
}
})
}
return fields
}
func walkNode(node parse.Node, fn func(parse.Node)) {
if node == nil {
return
}
fn(node)
// 递归遍历子节点（标准遍历方式）
switch n := node.(type) {
case *parse.ListNode:
for _, child := range n.Nodes {
walkNode(child, fn)
}
case *parse.ActionNode:
walkNode(n.Pipe, fn)
case *parse.PipeNode:
for _, cmd := range n.Cmds {
walkNode(cmd, fn)
}
case *parse.FieldNode:
// FieldNode 无子节点，无需递归
case *parse.IfNode, *parse.WithNode, *parse.RangeNode:
walkNode(n.Pipe, fn)
if n.ElseList != nil {
walkNode(n.ElseList, fn)
}
// 其他节点类型（CommentNode、TextNode 等）无需深入
}
}
func contains(slice []string, s string) bool {
for _, v := range slice {
if v == s {
return true
}
}
return false
}
func main() {
t, err := template.New("example").Parse(`<h1>{{.Title}}</h1><p>{{.Release}}</p>{{.Author.Name}}`)
if err != nil {
panic(err)
}
fields := extractFieldNames(t)
fmt.Println("Detected top-level fields:", fields) // 输出: [Title Release]
}✅ 关键说明与注意事项：
- 该方法基于静态解析，不执行渲染，因此安全可靠，适用于构建时分析；
- 仅捕获形如 {{.Xxx}} 的直接字段访问，不处理嵌套字段（如 {{.Author.Name}} 中的 Name 是 Author 的子字段，此处仅提取 Author）；若需深度提取，需扩展逻辑遍历 Ident 切片（如 fieldNode.Ident = []string{"." ,"Author", "Name"}）；
- 不识别 {{with .Data}}...{{.Field}}...{{end}} 等作用域内字段，因其语义依赖运行时上下文；
- 生产环境建议配合 template.Must() 和错误处理，并对 nil/空模板做防御性检查；
- 替代方案（如正则匹配 {{\.\w+}}）虽简单但易误匹配注释、字符串字面量或转义内容，AST 解析是唯一准确方式。
通过此方法，你可将模板参数清单用于自动化数据填充、前端 Schema 生成、CI/CD 中的模板合规性检查等高级场景，真正实现模板驱动的元编程能力。
