如何检测Go模板是否使用全部模板数据并触发Panic

给定模板字符串：

today i visited {{ .market }} to buy {{ .fruit }}

以及模板数据：

map[string]string{
    "market": "whole foods",
    "fruit":  "bananas",
    "veg":    "celery",
}

由于数据中的.veg未在模板中被使用，希望触发Panic，请问Go标准库的text/template能否实现这一需求？

Go标准库的text/template本身没有内置机制直接检测未使用的模板数据字段并触发Panic，但可以通过自定义逻辑实现这个需求，具体思路如下：

• 收集模板中用到的字段：利用text/template/parse包的AST遍历能力，实现一个遍历器，提取模板里所有被引用的顶层字段（比如示例中的market、fruit）。
• 对比数据源字段：把收集到的已用字段存到一个map里，再遍历传入的数据源，找出所有没出现在已用字段里的键。
• 触发Panic：如果存在未被使用的字段，直接调用panic()抛出异常。

下面是一个简化的实现示例：

package main

import (
	"fmt"
	"text/template"
	"text/template/parse"
)

// collectUsedFields 从模板AST中提取所有顶层使用的字段名
func collectUsedFields(tmpl *template.Template) ([]string, error) {
	var usedFields []string
	for _, tree := range tmpl.Templates() {
		parse.Walk(tree.Root, func(n parse.Node) bool {
			if fieldNode, ok := n.(*parse.FieldNode); ok {
				// 仅处理顶层字段（如 .market 中的 market）
				if len(fieldNode.Ident) == 1 {
					usedFields = append(usedFields, fieldNode.Ident[0])
				}
			}
			return true
		})
	}
	return usedFields, nil
}

// checkUnusedFields 检查数据源中是否有未被模板使用的字段，存在则触发Panic
func checkUnusedFields(tmpl *template.Template, data map[string]string) {
	usedFields, err := collectUsedFields(tmpl)
	if err != nil {
		panic(fmt.Sprintf("收集已用字段失败: %v", err))
	}

	usedMap := make(map[string]bool)
	for _, f := range usedFields {
		usedMap[f] = true
	}

	for key := range data {
		if !usedMap[key] {
			panic(fmt.Sprintf("数据源存在未使用字段: %s", key))
		}
	}
}

func main() {
	tmplStr := `today i visited {{ .market }} to buy {{ .fruit }}`
	tmpl, err := template.New("test").Parse(tmplStr)
	if err != nil {
		panic(err)
	}

	data := map[string]string{
		"market": "whole foods",
		"fruit":  "bananas",
		"veg":    "celery",
	}

	// 先执行未使用字段检查
	checkUnusedFields(tmpl, data)

	// 执行模板渲染
	err = tmpl.Execute(nil, data)
	if err != nil {
		panic(err)
	}
}

运行这段代码会触发Panic，输出数据源存在未使用字段: veg。

需要注意的是，这个示例仅适配顶层字段的简单场景，如果模板中用到嵌套字段（如.user.name）或者更复杂的数据结构，需要扩展AST遍历的逻辑来覆盖这些情况。

内容的提问来源于stack exchange，提问作者jchi2241