c.HTML() 不能直接传函数，必须用 SetFuncMap 全局注册；Go 模板引擎禁止函数值进入上下文，未注册则报“function not defined”；SetFuncMap 必须在 LoadHTMLGlob 之前调用，函数名大小写敏感且不带包名。
c.HTML() 不能直接传函数，必须用 SetFuncMap 全局注册 —— 这是 Go 模板引擎的硬性限制，不是 Gin 的 bug 或疏漏。
为什么 c.HTML() 的 data 参数里塞不了函数
Go 的 html/template 在执行时会深度遍历传入的 map[string]interface{} 或结构体，但明确禁止函数值进入模板上下文（防止任意代码执行）。所以哪怕你把函数塞进 gin.H{}，运行时也会 panic 或静默忽略。
- 错误现象：
template: index.html:12: function "formatTime" not defined（即使你定义了函数，但没注册） - 常见误操作：在 handler 里写
c.HTML(200, "a.html", gin.H{"now": time.Now, "format": formatTime})——format字段会被丢弃 - 根本原因：模板渲染前，Gin 用的是
engine.HTMLRender所绑定的*template.Template实例，它只认FuncMap里注册过的函数名
SetFuncMap 必须在 LoadHTML* 之前调用
顺序错会导致自定义函数完全不生效。因为 LoadHTMLGlob 内部会调用 template.New(...).Funcs(engine.FuncMap) 构建模板实例；如果此时 engine.FuncMap 还是空的，后续再设也晚了。
- ✅ 正确顺序：
r.SetFuncMap(...)→r.LoadHTMLGlob(...)→ 路由定义 - ❌ 错误顺序：
r.LoadHTMLGlob(...)→r.SetFuncMap(...)→ 函数在所有模板里都不可用 - 示例函数签名必须首字母大写、参数/返回类型明确：
func UnixToTime(timestamp int) string，不能是func unixToTime(...)
模板里怎么调用自定义函数
语法和内置函数一致，用双大括号包裹，形如 {{funcName arg1 arg2}}。注意它不支持方法链式调用或嵌套括号，所有参数都是空格分隔。
- 正确写法：
{{UnixToTime .CreatedAt}}、{{md5sum .Content}} - 错误写法：
{{.CreatedAt | UnixToTime}}（Go 模板不支持管道符传自定义函数）、{{UnixToTime(.CreatedAt)}}（括号非法） - 多参数函数示例：
func JoinStrings(sep string, strs ...string) string→ 模板中写{{JoinStrings "-" "a" "b" "c"}} - 如果函数返回 error，模板不会报错，但结果为空字符串 —— 建议函数内部做容错，不要依赖模板层处理异常
多个模板目录或热重载时要注意 FuncMap 复用
如果你用 LoadHTMLFS 或第三方热重载库（比如 gin-contrib/autotls 配合模板监听），SetFuncMap 只影响当前 engine 实例的 FuncMap 字段，但每次重新加载模板时会重建 *template.Template，所以只要 SetFuncMap 在加载前执行过一次，就足够了。
- 不用每个路由都重复注册，也不用在中间件里动态改
engine.FuncMap - 如果项目拆成多个子模块（比如 admin 和 user 模板分开加载），确保共用同一个
gin.Engine实例，否则需统一注册点 - 调试技巧：启动时打印
fmt.Printf("FuncMap keys: %v\n", r.FuncMap)确认函数名已注册成功
最容易被忽略的一点：函数注册后，模板里调用时名字必须和 FuncMap 的 key 完全一致，大小写敏感，且不能带包名前缀 —— time.Unix 是标准库函数，但你注册的 "UnixToTime" 就只能叫这个名字，模板里写 {{time.UnixToTime}} 会失败。
