必须在LoadHTMLGlob之前调用r.SetFuncMap()注册自定义模板函数，否则如UnitTime、md5等函数在模板中调用会静默失效，仅渲染为空或原始值。
模板函数必须在 LoadHTMLGlob 之前注册
自定义函数（比如格式化时间、计算 MD5）不会自动生效，r.SetFuncMap() 必须放在 r.LoadHTMLGlob() 之前。顺序反了，函数在模板里调用时会静默失败——页面不报错，但 {{UnitTime .timestamp}} 渲染为空字符串或原始值。
常见错误现象：模板中写好了 {{UnixToTime .CreatedAt}}，但浏览器只显示数字 1723358400，没变成 “2024-08-12 10:40:00”。
- 注册函数用
template.FuncMap类型，键是模板里调用的函数名（如"UnixToTime"），值是 Go 函数本身 - 函数签名必须严格匹配：参数类型、返回类型不能多也不能少；例如
func(timestamp int) string不能接收int64或返回error - 函数体内不要 panic，否则整个模板渲染中断，HTTP 返回 500
模板里调用自定义函数的语法和限制
Go 原生 html/template 的函数调用规则在 Gin 里完全继承，没有额外封装。它不支持方法链式调用，也不支持传多个命名参数。
正确写法：{{UnixToTime .CreatedAt}}、{{md5 .Content}}；错误写法：{{.CreatedAt | UnixToTime}}（这是 Hugo 或其他引擎语法）、{{UnixToTime .CreatedAt "2006-01-02"}}（不支持多参）。
立即学习“go语言免费学习笔记（深入）”；
- 所有自定义函数只能接收一个参数（或零个），且必须有返回值；若需格式化选项，得预先定义多个函数，比如
UnixToTimeShort和UnixToTimeLong - 函数名大小写敏感，模板里写的
{{unixtotime}}不会匹配 Go 中定义的UnixToTime - 如果函数返回空字符串或 nil，模板不会报错，但对应位置留空——容易误以为数据丢了，其实是函数逻辑返回了空
LoadHTMLGlob 路径通配符影响函数是否可用
r.LoadHTMLGlob("templates/**/*") 加载模板时，会把每个匹配到的文件注册为独立模板名（不含路径）。但如果你在模板里用了 {{template "header" .}} 这类嵌套引用，而 header.html 没被 glob 匹配到，就会报错 template "header" not defined——这和函数无关，却常被误判为函数失效。
- 确认所有被
{{define}}定义的子模板（如"header"、"footer"）都落在 glob 路径内；"templates/**/*"能覆盖子目录，"templates/*.html"则不能 - 自定义函数对所有已加载模板全局有效，不需要在每个模板里重复声明
- 调试时可临时加一行
{{printf "%#v" .}}到模板开头，看结构体字段和函数是否都在作用域里
函数参数类型不匹配导致静默丢值
最隐蔽的问题：传进函数的值类型和函数签名不一致，Go 会直接跳过调用，模板该位置输出空。比如函数定义为 func(timestamp int) string，但传的是 int64 字段，结果就是空白。
- 检查数据源字段类型：用
gin.H传值时，数字默认是float64（JSON 兼容性原因），不是int；所以gin.H{"ts": 1723358400}传进去的是float64，要改函数签名成func(timestamp interface{}) string并做类型断言 - 结构体字段导出时，确保类型与函数期望一致；比如
CreatedAt int64就得配func(t int64) string - 避免用
interface{}做中间层传递，容易丢失具体类型信息；优先用明确结构体或gin.H配合类型转换
gin.H 里的隐式转换这三处。它们不报错，但让函数“看起来没起作用”。 
