go 的 text/template 不提供直接提取变量名列表的 api，但可通过自定义函数（如 `require`）在执行时主动校验变量是否存在，从而避免因 map 中缺失键而静默返回空值的问题。
在 Go 的 text/template 中，当数据源是 map[string]interface{} 时，访问未定义字段（如 {{.missing}}）默认返回零值（如空字符串、0 或 nil），不会报错——这使得模板执行缺乏“变量存在性校验”能力，难以提前发现数据缺失问题。
虽然标准库不支持静态解析模板并提取所有 {{.xxx}} 变量名（即无法直接得到 [var var2] 这样的列表），但一个更可靠、生产就绪的替代方案是：改用运行时强制校验机制，通过自定义模板函数拦截变量访问，并在值为 nil（或未定义）时显式报错。
✅ 推荐方案：使用 require 自定义函数
首先注册一个 require 函数：
import (
"errors"
"text/template"
)
funcMap := template.FuncMap{
"require": func(val interface{}) (interface{}, error) {
// 注意：在 map 查找中，key 不存在时 template 会传入 nil
// 但需注意：某些零值（如 ""、0、false）是合法的，不应误判
// 因此更严谨的做法是结合上下文判断是否“真正缺失”
if val == nil {
return nil, errors.New("required field is missing or nil")
}
return val, nil
},
}
t := template.Must(template.New("example").Funcs(funcMap).Parse(`{{require .var}} is another {{require .var2}}`))然后在模板中统一包装变量访问：
// 模板内容（必须显式调用 require）
{{require .var}} is another {{require .var2}}当执行 t.Execute(w, data) 且 data 是 map[string]interface{} 时：
- 若 data["var"] 不存在或为 nil → require 返回错误，Execute 失败，可捕获并处理；
- 若 data["var2"] 存在且非 nil → 正常渲染。
⚠️ 注意事项：require 仅能捕获 nil，无法区分 "key 不存在" 和 "key 存在但值为 nil"。若业务允许 nil 值，需改用更精确的机制（如预定义结构体 + template.Option("missingkey=error")，但该选项仅对 struct 有效，对 map 无效）；若坚持静态提取变量名，需借助第三方解析器（如 github.com/tdewolff/parse/v2 手动词法分析模板文本），但易受嵌套动作（如 {{with .user}}{{.Name}}{{end}}）和转义干扰，不推荐用于生产环境校验；最佳实践是约定 + 工具 + 运行时防护三结合：用 require 保底线，配合单元测试覆盖关键模板，必要时辅以 JSON Schema 或 OpenAPI 定义数据契约。
综上，与其尝试不可靠的静态变量提取，不如用 require 函数将缺失变量转化为明确错误——简洁、可控、符合 Go 的显式错误哲学。
