c.HTML() 不能直接传函数因第三个参数仅支持 map[string]interface{} 或结构体，Go 模板引擎禁止函数值注入以保障安全；自定义函数须通过 SetFuncMap 全局注册，且必须在 LoadHTMLGlob 前调用。
为什么 c.HTML() 不能直接传函数进去
因为 c.HTML() 第三个参数只接受 map[string]interface{} 或结构体这类值类型，Go 模板引擎在解析时会拒绝函数值——这是安全限制，不是 Gin 的 bug。你试图这样写：c.HTML(200, "index.html", gin.H{"formatTime": func(t int) string {...}})，运行时会 panic，错误信息类似 template: can't evaluate field formatTime in type map[string]interface{}。
必须在 LoadHTMLGlob 之前调用 SetFuncMap
模板函数注册是全局生效的，且只在模板解析阶段读取一次。如果先 LoadHTMLGlob() 再 SetFuncMap()，已加载的模板不会识别新注册的函数，调用时静默失败或报 undefined function "xxx"。
- ✅ 正确顺序：初始化 router → 调用
r.SetFuncMap()→ 调用r.LoadHTMLGlob()→ 定义路由 - ⚠️ 函数签名必须首字母大写（导出），且参数/返回值类型明确，例如
func UnixToTime(timestamp int) string - 多个函数用 map 组织，键名就是模板里用的名字，比如
"UnixToTime": UnixToTime
模板里怎么调用自定义函数
语法和内置函数一致，用双大括号包裹，形如 {{UnixToTime .CreatedAt}}。注意它不依赖数据结构字段是否存在，只要传入的值类型匹配函数参数即可。
- 支持链式调用，比如
{{.User.Name | Upper | FirstN 5}}（前提是Upper和FirstN都已注册） - 传参个数必须严格匹配函数定义，少一个或多一个都会报错：
error calling UnixToTime: wrong number of args for UnixToTime: want 1 got 2 - 如果函数返回 error，建议在函数内部处理并返回空字符串或默认值，避免模板渲染中断
常见踩坑点：路径通配符与模板 define 冲突
当你用 r.LoadHTMLGlob("templates/**/*") 加载模板时，如果子目录下有未用 {{define}} 包裹的独立 HTML 文件（比如 templates/utils/date.html），它会被当作一个独立模板加载，而其中定义的函数无法跨文件使用——SetFuncMap 注册的是全局函数，但每个模板文件仍需单独引用。
- 推荐做法：把所有可复用逻辑抽成函数，而非模板片段；避免在非
define块中写裸 HTML - 调试技巧：在模板里加
{{printf "%#v" .}}查看当前上下文数据结构 - 性能提示：函数注册本身无开销，但频繁调用耗时函数（如 MD5、HTTP 请求）会阻塞模板渲染，应尽量轻量
