需先用funcs方法注册map[string]interface{}，函数须导出且参数/返回值符合约束（如末尾error会panic）；text/template与html/template函数不可混用，因转义机制不同；函数无法隐式访问上下文，须显式传参。
怎么给 text/template 注册自定义函数
直接调用 Funcs 方法，传入一个 map[string]interface{}，键是模板里要写的函数名，值是 Go 函数。注意：函数必须是可导出的（首字母大写），且参数和返回值类型得符合模板引擎的约束——比如不能有多个返回值（除非最后一个为 error），参数不能是指针或复杂结构体（基础类型、string、int、bool、interface{} 等常见类型才行）。
常见错误现象：template: xxx: function "xxx" not defined，多半是注册漏了、函数未导出、或者注册顺序错（必须在 Parse 之前）。
tmpl := template.New("test").Funcs(map[string]interface{}{"uc": strings.ToUpper})- 如果函数依赖外部状态（比如配置、DB 句柄），建议封装成闭包，但注意闭包捕获的变量生命周期要可控
- 避免在函数里做阻塞操作（如 HTTP 请求、数据库查询），模板渲染是同步串行的，会拖慢整个响应
text/template 和 html/template 的函数能混用吗
不能直接混用。虽然底层结构相似，但 html/template 对输出做了自动转义，它注册的函数默认认为返回的是“已安全”的内容；而 text/template 不转义，函数返回什么就原样输出。如果你把一个为 html/template 写的函数（比如返回带 HTML 标签的字符串）直接塞进 text/template，可能没问题；但反过来，把 text/template 的函数用在 html/template 里，容易导致 XSS（比如返回 "<script>alert(1)</script>" 被当作文本直接插入页面）。
- 函数逻辑本身可以复用，但注册时必须分清模板类型：
htmlTpl.Funcs(...)vstextTpl.Funcs(...) - 如果函数要返回 HTML 片段且用于
html/template，返回值类型应为template.HTML，否则会被转义 - 跨模板复用函数时，别图省事用全局 map 注册，容易类型错配
自定义函数里怎么访问模板上下文数据
没法直接访问。text/template 的函数签名只接收显式传入的参数，不提供类似 $ 或 . 这样的上下文隐式绑定。你得把需要的数据全作为参数传进去——比如想根据当前 item 的字段格式化时间，就得写成 {{dateformat .CreatedAt "2006-01-02"}}，而不是 {{dateformat "2006-01-02"}}。
立即学习“go语言免费学习笔记（深入）”；
- 如果参数太多，考虑把相关字段提前聚合进一个 struct，再传进去，比堆一堆参数清晰
- 不要试图在函数里用
reflect去“猜”调用方是谁，不可靠，且破坏模板的纯函数语义 - 某些场景下，用
with或range配合局部变量更轻量，不一定非得写函数
为什么函数返回 error 模板就 panic 了
因为 text/template 默认不处理函数返回的 error。如果你的函数签名末尾是 error（比如 func(string) (string, error)），模板引擎会检查这个 error：非 nil 就直接 panic，不会继续渲染。这不是 bug，是设计如此——它把错误当成严重异常，而非业务逻辑分支。
- 真要容错，得在函数内部处理错误并返回兜底值（比如空字符串、默认文案），别把 error 往外抛
- 调试时 panic 信息里通常带
template: xxx: xxx: error calling xxx: ...，重点看冒号后的内容 - 生产环境别依赖 panic 捕获来控制流程，模板层不适合做错误恢复
函数注册看着简单，但类型匹配、逃逸行为、上下文隔离这几个点，实际项目里最容易反复踩坑。尤其是多人协作时，函数命名和参数含义没文档，过两个月自己都看不懂当初为啥这么写。
