go模板中调用自定义函数必须先通过funcmap注册且在parse前绑定，返回template.html可避免双重转义，gin中需用setfuncmap或手动new+funcs，参数类型须严格匹配。
直接在 Go 模板里调用自定义函数是可行的，但必须通过 FuncMap 注册，且函数签名、执行时机和 HTML 转义规则稍有不慎就会导致渲染失败或 XSS 风险。
funcMap 必须在 Parse 之前绑定
模板对象一旦开始解析（ParseFiles 或 Parse），再调用 Funcs 就无效。常见错误是先 ParseFiles 再 Funcs，结果函数在模板中始终报 function "xxx" not defined。
-
template.New("name").Funcs(funcMap).ParseFiles(...)✅ 正确顺序 -
t := template.New("name"); t.ParseFiles(...); t.Funcs(funcMap)❌ 函数不会生效 - 如果用
LoadHTMLGlob（如 Gin），必须在LoadHTMLGlob前调用r.SetFuncMap(...)
自定义函数返回值类型决定是否自动转义
Go 的 html/template 默认对所有输出做 HTML 转义。若你的函数返回的是已安全的 HTML 字符串（比如富文本片段），必须显式返回 template.HTML 类型，否则会被双重转义成纯文本。
如果你了解HTML，CSS和JavaScript，您已经拥有所需的工具开发Android应用程序。本动手本书展示了如何使用这些开源web标准设计和建造，可适应任何Android设备的应用程序 - 无需使用Java。您将学习如何创建一个在您选择的平台的Android友好的网络应用程序，然后转换与自由PhoneGap框架到一个原生的Android应用程序。了解为什么设备无关的移动应用是未来的潮流，并开始构建应用程序，提供更
- 返回
string→ 自动转义：<b>hello</b>渲染为文字而非加粗 - 返回
template.HTML→ 跳过转义：return template.HTML("<b>hello</b>")才能正确渲染 - 别忘了 import
"html/template"，否则template.HTML不可识别
Gin 框架中注册 FuncMap 的两种写法
Gin 提供了更简洁的入口，但容易混淆 SetFuncMap 和手动创建 *template.Template 的适用场景。
- 用
r.SetFuncMap(...)+r.LoadHTMLGlob("templates/*")：适合统一注册、全局生效 - 用
template.New(...).Funcs(...).Parse(...)+c.HTML(...)：适合单次动态构造，比如从数据库加载模板内容 - 注意：Gin 的
c.HTML只认它内部管理的模板，不接受你手动生成的*template.Template实例
函数参数与模板内调用必须严格匹配
模板里写的 {{ myFunc .Field }}，对应 Go 函数签名必须是 func(string) string 或 func(interface{}) template.HTML 这类单入参形式。多参、指针、无参函数都不能直接用。
- 支持链式调用：
{{ .Time | formatTime }}，前提是formatTime接收time.Time类型 - 不支持默认参数或重载；传参个数/类型错会 panic：
reflect: Call using ... as type ... - 调试时可在函数开头加
log.Printf("got: %+v", arg)查输入值类型
最常被忽略的是函数返回类型和 FuncMap 绑定时机——这两个点出错，模板要么静默不渲染，要么报运行时 panic，很难一眼定位。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
