必须在Parse或ParseFiles之前调用Funcs，否则函数不可见；注册时机错误、函数签名不合规、模板类型混用、数据字段异常等均会导致函数失效。
必须在 Parse 或 ParseFiles 之前调用 Funcs，否则函数永远不可见——这不是配置遗漏，是模板 AST 已固化导致的硬性限制。
注册时机错：Parse 之后调 Funcs 就等于没注册
模板解析（Parse）会生成静态 AST，所有函数名都在此时被校验并绑定。一旦解析完成，Funcs 只能影响新克隆的模板，对当前实例无效。
- 错误写法：
t := template.Must(template.ParseFiles("a.tpl")); t.Funcs(myFuncs)→ 新注册的函数完全不生效 - 正确链路：
template.New("a.tpl").Funcs(myFuncs).ParseFiles("a.tpl")，顺序不能颠倒 - 若用
template.Must，需确保Must包裹的是整个链式调用，而非仅ParseFiles
函数签名不合规：首字母小写或参数类型错会导致静默丢弃或 panic
模板引擎只接受可导出函数（首字母大写），且参数/返回值类型必须严格匹配。类型不一致不会报编译错误，但运行时会 panic 或渲染为空。
- 函数必须首字母大写：
Upper✅，upper❌（会被FuncMap静默忽略） - 参数类型必须与模板中传入值一致：比如
{{.Time | FormatTime}}要求.Time是time.Time，否则reflect: Call using *string as type time.Time - 返回值最多两个，第二个必须是
error；多个返回值时模板只取第一个，其余丢弃 - 不支持闭包、匿名函数、方法值——只认具名、可导出、签名明确的函数变量
text/template 与 html/template 的函数不能混用
两者底层 AST 构建逻辑不同，html/template 默认启用 HTML 转义，text/template 不做任何转义。即使函数逻辑相同，注册到错误的模板类型里也可能因上下文差异失效。
- 用
html/template渲染 HTML？必须用html/template实例注册函数，别误用text/template -
html/template内置title、urlquery等函数，text/template一个都没有，连字符串首字母大写都得自己注册strings.Title - 若函数返回 HTML 片段且希望绕过转义，
html/template中需返回template.HTML类型，text/template无此机制
常见静默失败场景：nil 字段、未导出字段、管道左侧类型不匹配
函数注册成功、语法也正确，但模板里调用后输出为空，往往不是函数问题，而是数据侧异常。
-
{{.Name | Upper}}渲染为空？先检查.Name是否为nil或结构体中未导出字段（小写开头） - 管道操作要求左侧表达式结果类型与函数第一个参数类型完全一致，不支持隐式转换
- 嵌套模板中调用自定义函数时，注意当前作用域数据是否包含所需字段，
.Field在子模板中可能已丢失上下文 - 调试建议：在函数内部加
log.Printf输出入参，确认是否真的被调用；或用template.Must包裹解析过程，让语法错误提前暴露
最易被忽略的点是：模板名称（template.New("name") 中的 "name"）必须与 ParseFiles 加载的文件 basename 一致，否则嵌套模板引用（{{template "sub" .}}）会找不到目标模板——这和函数注册无关，但常和函数调用失败一起出现，容易误判。
