funcmap必须在loadhtmlglob之前注册，否则函数未定义；返回template.html可避免双重转义；参数类型须严格匹配签名；setfuncmap仅影响gin标准加载的模板。
FuncMap 必须在 LoadHTMLGlob 之前注册
很多人写完 UnitTime 函数，调用 r.SetFuncMap，却在模板里始终看到 function "UnitTime" not defined —— 根本原因是 r.LoadHTMLGlob("templates/**/*") 已经触发了模板解析，而 SetFuncMap 必须在解析前生效。
实际顺序只有一条有效路径：
-
r.SetFuncMap(...)必须放在r.LoadHTMLGlob(...)之前 - 不能先
LoadHTMLGlob，再SetFuncMap；也不能在路由 handler 里动态注册 - Gin 内部用的是单个
*template.Template实例，所有模板共享同一 FuncMap，注册一次即全局生效
函数签名必须返回 string 或 template.HTML
Go 模板默认对所有 {{.}} 和函数返回值做 HTML 转义。如果你的函数返回的是已构造好的 HTML 片段（比如富文本、带标签的摘要），直接返回 string 会导致双重转义：原本的 <b>hello</b> 渲染成纯文本。
正确做法是显式返回 template.HTML 类型：
- 返回
string→ 自动转义：return "<b>" + name + "</b>"渲染为文字 - 返回
template.HTML→ 跳过转义：return template.HTML("<b>" + name + "</b>")才能真正加粗 - 别忘了
import "html/template"，否则template.HTML编译不过
参数类型严格匹配，不支持泛型或 interface{} 推导
Gin 不会帮你做类型转换。模板引擎调用函数时，传入参数的类型必须和函数签名完全一致，否则运行时报 reflect: Call using x as type y 或静默失败。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
常见翻车点：
- 模板里传
{{.CreatedAt}}是int64，但函数定义为func UnixToTime(timestamp int) string→ panic - 想支持多种时间类型？得写多个重载函数，比如
UnixToTimeInt64和UnixToTimeFloat64 - 接收
interface{}然后用 type switch 判断？可以，但必须显式处理每种可能类型，且返回值仍需满足签名约束
Gin 中 SetFuncMap 和手动 New+Funcs 的区别
绝大多数场景用 r.SetFuncMap 就够了，但要注意它只影响 LoadHTMLGlob / LoadHTMLFiles 加载的模板。如果你手动用 template.New(...).Funcs(...).Parse(...) 创建独立模板实例，SetFuncMap 对它无效。
两种方式适用场景不同：
-
r.SetFuncMap→ 用于标准 Gin 模板加载流程，简单、统一、推荐 -
template.New(...).Funcs(...).ParseFiles(...)→ 仅当你需要隔离模板作用域（比如不同业务模块用不同 FuncMap）、或绕过 Gin 模板加载机制时才用 - 混用容易出问题：比如
r.LoadHTMLGlob后又自己 new 一个 template 并 Funcs，两者 FuncMap 不互通
最常被忽略的其实是错误处理和类型安全——函数里 panic 会直接让整个 HTTP 请求崩溃，而参数类型错配往往没有明显报错，只是模板渲染为空或乱码。上线前务必用真实数据类型跑一遍模板渲染路径。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
